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

Question

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

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

我需要更改什么才能使其读取“未知:”以外的内容。我可以在 Doxygen 中更改此设置吗？

Answer 1

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

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

例如，这应该有效:

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 生成的文档集进行处理，并显示可过滤的目录。

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

SEARCHENGINE           = NO
DISABLE_INDEX          = YES
GENERATE_TREEVIEW      = NO