【问题标题】:Embed doxygen in mediawiki在 mediawiki 中嵌入 doxygen
【发布时间】:2011-03-25 03:56:07
【问题描述】:

我的大部分文档都使用 mediawiki。然而,我们最近开始使用 doxygen 来记录我们的一个 C/C++ 重项目的 API。为了使我们的整体文档具有一致的外观和感觉,我想将 doxygen 的东西嵌入到 mediawiki 中。我该怎么做?

我查看了一些扩展,但到目前为止我发现的一切似乎都不成熟。

【问题讨论】:

    标签: mediawiki doxygen


    【解决方案1】:

    我知道的唯一扩展名是DoxyWiki。我认为这就是目前可用的全部内容。

    但也许这就是你所说的“半生不熟”的意思?

    (另见:Wikis and Wikipedia

    【讨论】:

    • 对,这就是我所说的半生不熟的意思。该网站上的下载链接已损坏,最后一次更新是在 2008 年。
    • @melonakos - 目前恐怕只有这些了。 :(
    • 如果您还没有找到解决方案并需要一个开始的地方,github.com/Coburn37/DoxygenMediawikiBot 对我来说效果很好。几个月前我做了这个,它在我需要的时候完成了工作,尽管 wiki 上的一些极端案例 doxygen 文档有问题。
    【解决方案2】:

    我没有尝试过 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 匹配项。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 2012-04-19
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2014-02-06
      • 1970-01-01
      相关资源
      最近更新 更多