Snow Leopard help bundle
Snow Leopard help bundle
- Subject: Snow Leopard help bundle
- From: Shane <email@hidden>
- Date: Wed, 9 Jun 2010 19:46:40 -0500
I'm trying to create a Snow Leopard help bundle, but can't figure out
what I've got wrong. I'm trying to follow the example in the second
ed. of Vermont Recipes. Just wanting to get the title page working
first.
1) I've created a folder in Finder for my help book w/ the following
sub-folders. This is not under my XCode project.
MyHelp.help
|- Contents
|- Info.plist
|- Resources
|- Shared
|- *.png
|- English.lproj
|- InfoPlist.strings
|- gfx
|- pgs
|- scrpt
|- sty
|- MyHelp.html
2) Created title page and saved under English.lproj.
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<title></title>
<meta name="Generator" content="Cocoa HTML Writer">
<meta name="CocoaVersion" content="1038.29">
<style type="text/css">
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica;
min-height: 14.0px}
span.Apple-tab-span {white-space:pre}
</style>
</head>
<body>
<p class="p1"><?xml version="1.0" encoding="utf-8"?></p>
<p class="p1"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0
Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"></p>
<p class="p2"><br></p>
<p class="p1"><html xmlns="http://www.w3.org/1999/xhtml"></p>
<p class="p1"><head></p>
<p class="p1"><span class="Apple-converted-space"> </span><meta
http-equiv="content-type" content="text/html; charset=utf-8"/></p>
<p class="p1"><span class="Apple-converted-space">
</span><title>MyHelp</title></p>
<p class="p1"><span class="Apple-converted-space"> </span><meta
name="AppleTitle" content="MyHelp.html"/></p>
<p class="p1"><span class="Apple-converted-space"> </span><meta
name="AppleIcon" content="../Shared/VRApplicationIcon016.png"/></p>
<p class="p1"><span class="Apple-converted-space"> </span><meta
name="robots" content="anchors"/></p>
<p class="p1"><span class="Apple-converted-space"> </span><link
href="sty/home_os.css" rel="stylesheet" type="text/css"
media="all"/></p>
<p class="p1"></head></p>
<p class="p2"><br></p>
<p class="p1"><body></p>
<p class="p1"><span class="Apple-tab-span"> </span><h3><img
src="../Shared/VRApplicationIcon032.png"</p>
<p class="p1"><span class="Apple-tab-span"> </span><span
class="Apple-tab-span"> </span>alt="My icon"</p>
<p class="p1"><span class="Apple-tab-span"> </span><span
class="Apple-tab-span"> </span>width="32" height="32"/></p>
<p class="p1"><span class="Apple-tab-span"> </span><span
class="Apple-tab-span"> </span>MyHelp</h3></p>
<p class="p1"></body></p>
<p class="p1"></html></p>
</body>
</html>
3) Here's my Info.plist (exported to text to post).
{
"CFBundleDevelopmentRegion" = "en-us";
CFBundleIdentifier = "com.my.help";
"CFBundleInfoDictionaryVersion" = "6.0";
CFBundleName = MyHelp;
CFBundlePackageType = BNDL;
"CFBundleShortVersionString" = 1;
CFBundleSignature = hbwr;
CFBundleVersion = 1;
CFBundleHelpBookName = "com.my.help";
"CFBundleHelpBookFolder" = "MyHelp.help";
HPDBookAccessPath = "MyHelp.html";
HPDBookIconPath = "Shared/VRApplicationIcon016.png";
HPDBookIndexPath = "My.helpIndex";
HPDBookKBProduct = "";
HPDBookKBURL = "";
HPDBookRemoteURL = "";
HPDBookTitle = "MyHelp";
HPDBookType = 3;
"HPDBookTopicListCSSPath" = "";
"HPDBookTopicListTemplatePath" = "";
}
4) Contents of my InfoPlist.strings.
/* Localized version of Info.plist keys */
HPDBookTitle = "My Help";
5) Used HelpIndexer to create My.helpindex file.
6) In my XCode project, I added via "Add -> Existing Files" to the
Resources folder the top level MyHelp.help folder and selected "Create
Folder References for any added folders" before clicking the add
button.
7) To register the bundle, I've added the following two properties to
Info.plist (as already shown in step 3 in this post).
CFBundleHelpBookFolder = MyHelp.help
CFBundleHelpBookName = com.my.help
8) In my MainMenu.nib, my Help menu item in the Help menu is connected
to the First Responder's showHelp:
Yet when I build and run my application, I get the "Help isn't
available" dialog window for my application.
Anyone have ideas where I'm going wrong?
Thanks,
_______________________________________________
Cocoa-dev mailing list (email@hidden)
Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden