documentation - 生成文档 doxygen 样式而不注释代码

Question

我正在寻找一种创建与 Doxygen 风格相似的文档页面的方法，但我不想将文档作为注释放入我的代码中。最佳方法是将其键入普通文本文件或其他内容，然后从中生成页面。

据我了解，Doxygen 不支持这一点，所以我想知道是否有任何替代方案可以满足我的需求。

Answer 1

*.dox在您放置常规文本文件的文件夹的 INPUT 参考部分中的文件中创建。例如：

INPUT = ./supplement

之后，您可以创建常规文本文件，只需放在/*!开头和*/结尾即可。并用\page或其他标签对其进行分类。例如：

我的.txt

/*!
  \page threading Describe Threading tech
  In details this describe cases:
  \li case 1
  \li case 2
*/

您可以在单个文件中放置多个\page声明（请参阅http://www.doxygen.nl/manual/commands.html#cmdpage）