10

私はEclipse+PDTで開発しています。コードにphpdocコメントを追加してきましたが、実際にはEclipseで結果のドキュメントを生成することはありませんでした。どうすればよいですか？Eclipseにいくつかの機能がありますか、それともドキュメントの生成を外部で行う必要がありますか？

4

3 に答える 3

5

ドキュメントを生成するには、PEAR パッケージとしてインストールできるphpDocumentorを使用する必要があります。

次に、コマンドラインから呼び出す必要があります。実際、Eclipse PDT から呼び出されるのを見たことがありません。

優れた解決策は、継続的インテグレーション プラットフォーム (たとえば、 phpUnderControlを使用) を用意し、ビルド構成ファイルで phpdoc の作成に統合することです。このように、phpdoc は誰かがコミットするたびに (または 1 日に 1 回、またはいつでも ^^ )生成されます。

Eclipse PDT では、「外部ツール」を呼び出すことができます (メニューの「実行 > 外部ツール」を参照)。これにより、phpdoc コマンドを起動できます (CLI から実行する場合と同様)。しかし、Zend Studio が提供するものほどユーザーフレンドリーではないことは間違いありません。価格も同じではありません ^^

于 2009-07-26T13:57:31.463 に答える
1

はい、Zendでこれを行うためのウィザードがあります。この簡単なガイドをご覧ください。

または、外部起動構成を作成して、標準のphpDocumentorを呼び出すこともできます。

  1. [実行]->[外部ツール]->[外部ツールの構成...]を選択します。
  2. 左側のペインで、[プログラム]、[新しいアイコン]（ペインの一番上のアイコン）の順に選択します。
  3. 右側のペインで、[メイン]タブを選択します。
  4. 「名前：」フィールドにgenerate_docと入力します。
  5. [場所：]フィールドにphpdoccliツールへのパスを入力します。
  6. たとえば、現在のプロジェクト入力$ {project_loc}の場合など、必要な引数を[引数]フィールドに入力します。
  7. 外部構成を実行するには、「実行」を選択します。

構成を再実行するには、いくつかの選択肢があります。

  1. メニューバーの外部ツールアイコンhttp://help.eclipse.org/ganymede/topic/org.eclipse.cdt.doc.user/images/icon%5Fext%5Ftools.png"から外部ツールアイコンを選択し、 generate_docをクリックします。
  2. [実行]->[外部ツール]->[generate_doc]を選択します
  3. Alt + R、E、1を押します（generate_docがリストの最初の項目であると想定し、そうでない場合は適切な番号を選択します）
于 2009-07-26T13:45:25.830 に答える