0

私の理解は次のとおりです。

  • Java ドックレット API は、以下をルートとする単なる API (インターフェースで構成される) です。com.sun.javadoc
  • Javadoc が実行されると、実行時にバインドする Doclet API impl が検索されます。
  • そのような impl が存在しない場合は、何らかのデフォルトが使用されます (したがって、独自の CSS ファイルなどを指定しなくても Javadoc を生成できます)。
  • Google の DocLava は、そのような Doclet API impl の 1 つです。

これが真である場合、どのようにしてデフォルトよりも異なる Doclet impl (DocLava など) を指定するのでしょうか? 私がベースから外れているとすれば、Javadoc ツール、Doclet API、および DocLava はすべて互いにどのように関連しているのでしょうか?

4

1 に答える 1

4

デフォルトで別のDoclet impl (DocLavaなど) を指定するにはどうすればよいですか?

javadoc ツール ドキュメントのコマンド ライン オプションのセクションを参照してください。-doclet引数で使用するドキュメントを指定します。

-doclet class

ドキュメントの生成に使用されるドックレットを開始するクラス ファイルを指定します。完全修飾名を使用してください。このドックレットは、コンテンツを定義し、出力をフォーマットします。-doclet オプションを使用しない場合、javadoc は標準ドックレットを使用してデフォルトの HTML 形式を生成します。このクラスには start(Root) メソッドが含まれている必要があります。この開始クラスへのパスは、-docletpath オプションによって定義されます。

たとえば、MIF ドックレットを呼び出すには、次を使用します。

   -doclet com.sun.tools.doclets.mif.MIFDoclet

特定のドックレットを実行する完全な実際の例については、 MIF ドックレットの実行を参照してください。

DocLava ドックレットの使用に関する詳細は、DocLava 入門ガイドに記載されています。

Doclava を使用するために Javadoc に渡すコマンド ライン引数は次のとおりです。

-doclet com.google.doclava.Doclava
-docletpath ${jar.file}
于 2012-05-15T23:02:43.540 に答える