macos - 如何使用 Doxygen 为 Dash 指定关键字？

Question

我正在使用 Doxygen 为我的项目生成文档，该文档生成的文档集几乎可以与dash完美配合。

我想知道的是如何在dash中设置搜索关键字；默认为“未知：”

我需要更改什么，以便它读取“未知：”以外的内容。我可以在 Doxygen 中更改它吗？

Answer 1

我是 Dash 的开发者。Dash 使用 docset 内 Info.plist 文件中的 DocSetPlatformFamily 键来确定默认关键字。不幸的是，据我所知，Doxygen 没有设置这个值的选项。我将联系 Doxygen 团队并要求他们添加此选项。随意做同样的事情。

目前，我最好的建议是编写一个后生成脚本，在 Info.plist 文件中添加所需的密钥（它只是一个文本文件）。

例如，这应该有效：

perl -pi -w -e "s/<\/dict>/<key>DocSetPlatformFamily<\/key><string>__DESIRED KEYWORD__<\/string><key>DashDocSetFamily<\/key><string>doxy<\/string><\/dict>/s" Info.plist

注意：我还添加了一个值为“doxy”的“DashDocSetFamily”条目。这将导致 Dash 将文档集作为 Doxygen 生成的文档集处理，并显示可过滤的目录。

如果您还没有找到它们，这里有一些推荐的设置，用于生成用于 Dash 的 Doxygen 文档集：

SEARCHENGINE           = NO
DISABLE_INDEX          = YES
GENERATE_TREEVIEW      = NO