c - 结合 Docbook 和 Doxygen 文档类型。

Question

我正在为我们的软件库编写新文档，我想知道如何将我认为应该用 DocBook 编写的通用文档与基于 Doxygen 的 API 参考结合起来。

Doxygen 部分已经存在，所以我更愿意保留它，但使用 DocBook 只是一个想法，我愿意接受任何想法。用 Doxygen 编写整个文档是可能的，但在我看来这不是最好的方法。

谢谢！

Answer 1

我建议您重新考虑采用全氧方式。尽管使用 Doxygen 编写详尽的文档一开始可能看起来很麻烦，但从长远来看，保持两个文档的一致性将是更多的工作。除了通过结合两者的输出产品来增加工作量之外。

Doxygen 可以将 Markdown 文件作为页面包含到您的文档中（参见手册的这一部分），并可以将详细的文档外部化，以免过多地破坏源文件（参见手册的其他部分）。

我还应该补充一点，我以前没有使用过 Docbook 的第一手经验，所以这可能会让我对 Doxygen 有一点偏见。