documentation - 在 doxygen 中重用 texinfo

Question

是否有任何工具可以将 texinfo 文件转换为 Doxygen 可以处理的东西（可能是降价）？我有一堆旧的 texinfo 文件，我想将它们与我们拥有的 doxygen 文档链接起来。我想如果必须的话，我会从 texinfo 生成 html 并从 doxygen 源文件链接到该文件，但我宁愿将 texinfo 文档集成到 doxygen 文档中。

Answer 1

我一直在为我的项目的遗留文档而苦苦挣扎。我找到了一个解决方案，虽然不是完全自动化的，但它是可行的。由于 Doxygen 可以处理markdown文件，我一直在将我的 texi 文件转换为 mardown。

1. 通过将texi文件转换为htmltexi2html

   $ texi2html foo.texi

2. 通过将html文件转换为markdownpandoc

   $ pandoc -f html -t 降价 -o foo.md foo.html

3. 使用您选择的降价编辑器清理生成的降价文件。它们有很多，但在 OSX 上我使用Markdown Pro.

4. 编辑Doxyfile并告诉 Doxygen 处理目录中的降价文件。要么将文件添加到INPUT列表中，要么将.md扩展名添加到FILE_PATTERNS标签中。更多关于Doxygen's markdown 支持的信息可以在这里找到：

   • http://www.doxygen.nl/manual/markdown.html