PHP 的外部文档，没有 DocBook

Question

我需要一个 PHP 项目的文档系统，我希望它能够将外部文档（用例、项目范围等）与从代码 cmets 生成的文档集成。似乎 phpDocumentor 的功能集完全正确，但外部文档必须用 DocBook 编写，这对我们的团队来说太复杂了。

如果是在 python 中，sphinx 将非常适合这项工作（ReST 绝对比 docbook 简单）。有什么方法可以将外部 ReST 文档与从 phpdoc 中提取的文档集成在一起？我是否应该将外部文档分开（例如，将 ReST 用于外部，将 phpdoc 用于内部）？或者您对管理外部文档有更好的建议吗？

Answer 1

您可以使用 pandoc 将 ReST 转换为 DocBook。

Answer 2

以 DocBook 样式转换 wordpress 帖子。这是示例。

http://hashfold.com/techfold/wordpress-how-to-generate-docbook-style-posts/