PHP的外部文档，没有DocBook

Question

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

如果它是在python中，那么sphinx对于这项工作来说就是完美的（ReST绝对比docbook简单）。有什么办法可以将外部ReST文档与从phpdoc中提取的文档集成在一起吗？我是否应该单独分析外部文档（例如，使用ReST for external和phpdoc for internal）？或者您对管理外部文档有更好的建议吗？

Answer 1

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

Answer 2

转换DocBook风格的wordpress帖子。这是样本。

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