诊断 Mac 帮助关键字索引？答案

【问题标题】：Diagnosing Mac Help keyword indexing?诊断 Mac 帮助关键字索引？
【发布时间】：2023-03-08 09:33:01
【问题描述】：

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

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

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

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

Help Indexer 日志指出它已索引所有 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。不过，我不知道如何检查它的内容。

对我缺少的东西有什么想法吗？

【问题讨论】：

标签： macos apple-help

【解决方案1】：

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

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

【讨论】：

（迟来的）感谢您提供的链接 - 这似乎已经解决了问题。非常感谢！

【解决方案2】：

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

【讨论】：

您好，感谢您的建议。帮助手册在应用程序的 info.plist 文件中注册，但不包含其自己的单独的 info.plist 文件。创建一个似乎并没有影响潜在的行为。帮助索引器/hiutil 返回与上述相同的诊断信息。再次感谢。

【解决方案3】：

我刚刚遇到了空白Apple帮助条目的问题，经过几天我能想到的一切尝试，终于找到了解决方案。将 META NAME="ROBOTS" CONTENT="NOINDEX" 添加到空白条目的页面（在我的例子中是 index.html，也就是登录页面或访问页面）。然后我重新索引了 HTML 页面，看，没有更多的空白条目。甚至不需要删除帮助查看器缓存。

[编辑为标签隐藏内容：-]

【讨论】：