質問

誰かが自分のことを文書化するために他に何かを使っていますか PHP コードよりも PHPDoc?同じドキュメント構文を読み取り、より豊富な出力を提供するツールはありますか?

役に立ちましたか?

解決

私もドキシゲンに行きます。

理由はいくつかあります。

  • phpdoc タグやその他の一般的なタグと互換性があります。相互運用可能です
  • さまざまなプログラミング言語で動作します。より良い時間投資
  • 代替構文もあります:自分に合ったコメントスタイルを選択できます
  • 高度なフォーマット/タグ付け/メタデータにより非常に効率的
  • どのIDEにもリンクされていないGUIとEclipseプラグインもあります

そして今でも無料、マルチプラットフォーム、オープンソースです:-)

学ぶのは簡単ですが、phpdoc よりもはるかに内容が豊富なので難しいです。

他のヒント

DocBlox を試してみてはいかがでしょうか。これは phpDocumentor の代替となることを目的としていますが、PHP 5.3 の完全サポートなどの追加機能もサポートされています。さらなる利点は、非常に高速であり、使用するメモリが比較的少ないことです。

詳細については、 http://www.docblox-project.org または、次の場所でデモをご覧ください。 http://demo.docblox-project.org/default

phpDocumentor 以外のオプションは次のとおりです。 ドキシゲン ドキュメントと PHP サポート。

ドキシゲン (www.doxygen.org).

アピジェン

http://apigen.org/

ApiGen は、PHP 5.3 名前空間、パッケージ、ドキュメント間のリンク、PHP 標準クラスと一般ドキュメントへの相互参照、強調表示されたソース コードの作成、および PHP 5.4 特性の実験的サポートをサポートしています。

ドックブロックス

http://www.docblox-project.org/

あらゆる規模のプロジェクトと継続的インテグレーションを目的とした、PHP 5.3 互換の API ドキュメント ジェネレーター。

Zend Framework 2 を完全に解析して変換できる

使っています ドキシゲン また、さまざまなキーワードにもすぐに慣れます。それらは一種の説明不要です。;)

RubyDoc これも素晴らしく、特に Rdoc のレイアウトが気に入っています。

Doctrine は PHPDoctor を使用していますが、私のテストでは 5.3 でうまく動作するようです。

http://peej.github.com/phpdoctor/#download

PHPでは使ったことないですが、 酸素 この言語をサポートしていると主張しています。

PHP 5.3 以降のコードを文書化する必要がある場合。Ted Kulp の名前空間を使用している場合 PHPDoctor のフォーク それがあなたの答えかもしれません。

ライセンス: CC-BY-SA帰属
所属していません StackOverflow
scroll top