2012-07-18 68 views
7

有人可以指示我一个关于如何为Cocoa应用程序创建帮助手册的最新教程。我在网上找到的所有东西都是陈旧过时的,Apple的文档并没有让它更清晰。我无法弄清楚的一个具体事情是如何创建一个.help包。苹果帮助手册教程

+6

我只是想发表评论,试图为可可应用程序创造出一个非常简单的帮助的书总是在我极度沮丧的练习。我有一段可怕的时间让帮助索引器工作和/或从帮助菜单中选择时出现。 – Clay 2012-12-07 03:06:31

回答

11

本文件包含的帮助包布局信息(和苹果帮助一般):

http://developer.apple.com/library/mac/#documentation/Carbon/Conceptual/ProvidingUserAssitAppleHelp/authoring_help/authoring_help_book.html%23//apple_ref/doc/uid/TP30000903-CH206-TPXREF104

在另一方面,帮助包格式从未真正被要求(在某些OS版本尽管苹果多年来一直使用它,但并没有得到官方的支持)。

我所做的全部是CFBundleHelpBookFolderCFBundleHelpBookName(在Info.plist)。后者是一个可读的标题,例如“YourApp帮助”,它必须与HTML中的AppleTitle匹配。

我将CFBundleHelpBookFolder设置为简单的名称“帮助”,然后在应用程序包中创建文件夹Something.app/Contents/Resources/English.lproj/Help。在此目录中,我将index.html(包含所需的<meta>标签AppleTitleAppleIcon)和ExactMatch.plist。 (顺便说一下,它实际上是一个好主意,如果一切进入该点下面的子文件夹,以便帮助系统不必搜索到很多顶层的文件。)