PHP、無DocBook形式のための外部ドキュメント
-
21-09-2019 - |
質問
私は、PHPプロジェクトのドキュメントシステムを必要と私はコードのコメントから生成されたドキュメントと外部ドキュメント(ユースケース、プロジェクトのスコープなど)を統合できるようにしたかったです。 phpDocumentorのは、正確に右の機能セットを持っているようだが、外部のドキュメントは、我々のチームのためにあまりにも複雑であるDocBook形式で記述する必要があります。
それはpythonであった場合は、、スフィンクスは(残りはDocBook形式よりも間違いなく簡単です)この仕事のためのちょうど約完璧になります。私はphpdocのから抽出されたドキュメントを外部のRESTドキュメントを統合することができる方法はありますか?私は、外部のドキュメント(例えば内部用の外部とはphpdocのための残りを使用)を分離すべきか?それとも外部のドキュメントを管理するためのより良い提案を持っていますか?
解決
あなたはpandocを使用してDocBook形式への残りの部分を変換することができます。
他のヒント
DocBookのスタイルで
コンバートワードプレスの記事。ここではサンプルです。
http://hashfold.com/techfold/wordpress - どのように対を生成-のDocBookスタイル・ポスト/ の
所属していません StackOverflow