【发布时间】:2011-03-25 03:56:07
【问题描述】:
我的大部分文档都使用 mediawiki。然而,我们最近开始使用 doxygen 来记录我们的一个 C/C++ 重项目的 API。为了使我们的整体文档具有一致的外观和感觉,我想将 doxygen 的东西嵌入到 mediawiki 中。我该怎么做?
我查看了一些扩展,但到目前为止我发现的一切似乎都不成熟。
【问题讨论】:
我的大部分文档都使用 mediawiki。然而,我们最近开始使用 doxygen 来记录我们的一个 C/C++ 重项目的 API。为了使我们的整体文档具有一致的外观和感觉,我想将 doxygen 的东西嵌入到 mediawiki 中。我该怎么做?
我查看了一些扩展,但到目前为止我发现的一切似乎都不成熟。
【问题讨论】:
【讨论】:
我没有尝试过 DoxyWiki。
您可以编写一个 wiki 特殊页面,如 Special:FileSystem 或设置一个命名空间,其“子页面”对应于文件系统中的 doxygen HTML 文件。问题是 doxygen 想要呈现自己的导航,这与典型的 MediaWiki 皮肤的侧边栏等有点不兼容。
您可以将 doxygen HTML 文件放在 Web 服务器上的另一个目录中并链接到它们。为了使这个更干净,你可以为它定义一个interwiki 前缀,比如“docs”,然后你可以链接到带有常规wiki 链接[[docs:php/Action_8php.html|see the Action.php reference docs]] 的doxygen 网页。您可以对 doxygen 输出进行皮肤处理,使其看起来更像您的 wiki 皮肤。但是您的 wiki 的搜索框不会返回 doxygen 匹配项。
【讨论】: