PHP, hiçbir DocBook'da için dış belgeleri

2 Cevap php

Ben bir PHP projesi için bir dokümantasyon sistemi gerek ve ben bunu kod yorumlardan üretilen belgeler ile dış belgelere (kullanım durumları, proje kapsamı vb) entegre edebilmek için istedim. Bu phpDocumentor bizim takım için çok karmaşık olan tam doğru bir özellik seti, ancak dış belgeleri DocBook'da yazılmalıdır var gibi görünüyor.

Bu Python olsaydı, sfenks, sadece mükemmel hakkında bu iş için (Rest kesinlikle docbook daha basittir) olacaktır. Ben phpdoc çıkarılan dokümanlar ile dış kalanını belgelerine entegre herhangi bir yolu var mı? Ben sadece harici (dış için örneğin kullanan REST ve iç phpdoc) belgelerine ayırmak gerekir? Yoksa dış belgeleri yönetmek için daha iyi bir öneriniz var mı?

2 Cevap

Sen Pandoc kullanarak DocBook'da Rest dönüştürebilirsiniz.

DocBook tarzı wordpress mesajları dönüştürmek. Burada örnek.

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