诊断Mac帮助关键字索引？

Question

我无法哄骗我的应用程序的“帮助→搜索”功能，以显示与我的应用程序中有用（和唯一）关键字相关的主题。只显示一个关键字。

后台：我在程序的子目录中创建了几个html帮助页面（示例：index，accuracy，convert）。如果我调用主帮助，index.html文件显示正常。从那里，我可以点击进入任何其他主题页面。

问题：如果我尝试使用关键字搜索功能，则只显示“准确度”和空白指示符（拉出index.html）。我有其他关键字，如“坐标”，应该指向一个特定的页面，但没有出现。

到目前为止我做了什么：除了重新浏览documentation（此时我有点睡眼惺me）之外，我还运行了每一页通过BBEdit的语法检查器。我还搜索了StackOverflow以获取与该问题相关的信息。因为关键词无处不在，this是主要的主题匹配，但我已经过了好看。

帮助索引器日志指出它已将所有html文件编入索引，在每个文件中找到KEYWORDS和DESCRIPTION元标记（按照the Help Book的建议）：

droot.html -- File has KEYWORDS meta tag content being indexed.
gc.html -- File has KEYWORDS meta tag content being indexed.
index.html -- File has KEYWORDS meta tag content being indexed.
droot.html -- File has DESCRIPTION meta tag used for abstract.
gc.html -- File has DESCRIPTION meta tag used for abstract.
index.html -- Finished parsing
droot.html -- Finished parsing
gc.html -- Finished parsing
(etc)

发布包（?/Contents/Resources/MacFizzyCalcHelp/目录）中的* .helpindex文件大约是25k。不过，我不知道如何检查它的内容。

对我缺少什么的想法

Answer 1

出现问题的原因有很多。一旦我发现苹果开发者文档有错误（描述锚点）。您是否在应用程序Info.plist中注册了帮助手册？帮助手册是否包含自己的信息plist文件？您可以使用hiutil检查helpindex文件。我希望这能帮到你。

Answer 2

我在Apple支持网站上发现以下帖子非常有用，当我遇到类似的问题时，我的帮助手册的帮助主题没有使用搜索功能显示：

https://discussions.apple.com/thread/3442044

Answer 3

我只是遇到了空白的Apple帮助条目问题，经过几天的尝试后，终于找到了解决方案。添加到空白条目的页面（在我的情况下为index.html，也就是登录页面或访问页面）。然后，我重新索引了HTML页面和索引，不再有空白条目。甚至无需删除帮助查看器缓存。