在doxygen中重用texinfo

Question

有没有什么工具可以将texinfo文件转换成Doxygen可以处理的文件(可能是markdown)？我有一堆旧的texinfo文件，我想要链接到我们拥有的doxygen文档中。如果有必要，我想我会从texinfo生成html，并从doxygen源文件链接到html，但我更愿意将texinfo文档集成到doxygen文档中。

Answer 1

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

1. 通过texi2html将文本文件转换为html

$ texi2html通过pandoc foo.texi

• Convert标记html文件

$ pandoc -f html -t markdown -o foo.md foo.html

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

• Edit你的Doxyfile，并告诉Doxygen处理目录中的markdown文件。将文件添加到INPUT列表中，或者将.md扩展名添加到FILE_PATTERNS标记中。有关Doxygen的降价支持的更多信息可以在这里找到：

- [http://www.doxygen.nl/manual/markdown.html](http://www.doxygen.nl/manual/markdown.html)

​