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/