PHP的外部文档，没有DocBook

Question

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

如果是在Python中，狮身人面像将是完美的工作（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/