问题标签 [apple-help]

对 - 所以我创建了一本帮助手册，做了所有正确的事情，仔细检查了我的plist和index.html文件，我得到的只是臭名昭著的

所选主题当前不可用。

尝试打开帮助手册时，控制台中的唯一条目是纯文本

不太有帮助。

然后去哪儿？Apple Help
有什么调试技巧吗？
登录以打开？任何事物..？

我尝试使用AHRegisterHelpBook和在系统偏好设置窗格中打开帮助手册AHGotoPage。它在 OS 10.9 下工作，但在 10.12 下失败。

具体来说，调用返回 noErr，但我第一次调用AHGotoPage时，帮助窗口打开并显示一条消息，提示找不到帮助。随后的调用AHGotoPage似乎什么都不做。还有其他方法可以打开嵌入式帮助书吗？

更新：不知何故，我忽略了 Cocoa 类的存在NSHelpManager。在使用锚更新我的帮助书索引并转换为使用NSHelpManager方法registerBooksInBundle:和openHelpAnchor:inBook:之后，我仍然处于它在小牛队中工作而在 Sierra 中失败的情况。

我想知道是否有一些 Apple 帮助书的模板开始。

但是，由于我不是专业程序员，所以我偶然发现了制作苹果帮助书。首先，我对苹果帮助文档的质量感到惊讶。Jekyll Apple Help的作者称之为拜占庭，这正是我的第一印象。但是，我能够学习基本概念。

当我检查了 Apple 如何为他们的应用程序编写教程时，我意识到他们只使用简单的 HTML 文件，没有任何 JS 和 CSS。

所以问题是：

如何像苹果一样做到这一点？ 这是在苹果帮助查看器中神奇地发生的事情吗？是否有一些隐藏的方式如何将样式和脚本链接到其他地方？如果这是必须手动制作的东西

如果我必须处理 JS 和 CSS - 该怎么做？它是必须在 x 代码中编程的东西吗？或者最终，有人可以为我们提供文档化的帮助手册模板吗？

我正在尝试为我准备发布的 macOS 应用程序制作 Apple 帮助手册。但是，我正在尝试使锚点在我的 HTML 中工作。按照苹果的定义：

“锚点允许您唯一标识帮助手册中的主题。当用户点击指向锚点的链接时，帮助查看器会加载包含锚点的页面。......您还可以使用锚点从应用程序中加载锚定页面：调用 NSHelpManager 方法 openHelpAnchor:inBook: ..."

苹果的例子：<a name="ArrivalTimesUsingStopID"></a>

在我的 Apple 中，我有一个 NSAlert，它具有以下代码来显示帮助按钮，以便当您单击它时，它会打开指定的锚字符串。

运行代码确实会显示帮助按钮，并且 Mac 帮助确实会打开，但是会出现一个错误，指出找不到指定的内容。不知道为什么锚不工作，因为如果我转到帮助菜单并从那里打开它，我可以访问帮助手册。

此外，Apple 的文件指出：

NSAlert、SFChoseIdentityPanel、SFCertificatePanel 类为对话框提供帮助按钮。要显示此类帮助按钮并将其链接到帮助手册中的锚点，请在这些类中使用方法 setShowsHelp: 和 setHelpAnchor:。

以及这些属性的文档NSAlert状态：

-setShowsHelp:YES 向警报面板添加帮助按钮。当按下帮助按钮时，首先咨询代表。如果委托没有实现 alertShowHelp: 或返回 NO，则 -[NSHelpManager openHelpAnchor:inBook:] 使用 nil book 和 -setHelpAnchor: 指定的锚点调用，如果有的话。如果委托返回 NO 并且没有设置帮助锚点，则会引发异常。

...所以我知道我正在正确使用这两个。

我还了解每次更新 Apple 帮助手册 HTML 文档时都需要创建一个 .helpindex 文件。我正在使用 developer.apple.com 上的 Additional Xcode Tools 中的“Help Indexer.app”。我确保：

• 我设置了索引所有锚点的选项。
• 任何带有锚点的 HTML 页面都<meta name="ROBOTS" content="ANCHORS">在标题中，因此锚点会被编入索引。
• 我的 Apple 帮助书 plist 文件正确指向由“Help Indexer.app”创建的 .helpindex 文件。

但即使有了所有这些，我也无法将 Apple 帮助书打开到正确的锚点，甚至无法打开 Apple 帮助书的标题页。

我已阅读 https://developer.apple.com/library/archive/documentation/Carbon/Conceptual/ProvidingUserAssitAppleHelp/user_help_intro/user_assistance_intro.html#//apple_ref/doc/uid/TP30000903-CH204-CHDIDJFE

从封面到封面多次，我无法在网上找到解决方案或任何地方。

我也尝试过手动打开它，但它只是打开相同的错误，说无法使用以下代码找到指定的内容：

使用nilinBook 参数也不起作用：

有任何想法吗？