Externe Dokumentation für PHP, ohne DocBook

Question

Ich brauche ein Dokumentationssystem für ein Projekt PHP, und ich wollte es in der Lage sein, externe Dokumentation zu integrieren (Use Cases, Projektumfang etc.) mit der Dokumentation von Code-Kommentaren erzeugt. Es scheint, dass phpDocumentor hat genau das richtige Feature-Set, aber externe Dokumentation muss in DocBook geschrieben werden, die für unser Team zu komplex ist.

Wenn es in Python wäre, würde Sphinx für diesen Job einfach perfekt sein (ReST ist auf jeden Fall einfacher als DocBook). Gibt es eine Möglichkeit, externe ReST Dokumentation mit den extrahierten docs aus phpdoc integrieren können? Soll ich trenne nur die externe Dokumentation (z. B. verwendet ReST für externe und phpdoc für intern)? Oder haben Sie einen besseren Vorschlag für die externe Dokumentation Verwaltung?

Answer 1

Sie können sich darauf zu DocBook konvertieren pandoc verwendet wird.

Answer 2

convert Wordpress Beiträge in DocBook-Stil. hier ist die Probe.

http://hashfold.com/techfold/wordpress -wie-to-generate-docbook-style-Beiträge /