Maven プラグイン プロジェクトから標準のドキュメント Web サイト (このような) を生成できるようです。プラグイン プロジェクトで実行しようとmvn site
しましたが、期待されるドキュメント (Mojo の目標、パラメーターなどを示すページ) が生成されません。これらの Web ページを生成するために呼び出さなければならない他の目標はありますか? Maven v. 2.1.0 を使用しています。
4 に答える
サイトのドキュメントに含まれるプラグインのドキュメント (ゴール、パラメーターなど) を取得するには、pom.xml に次の内容を追加する必要があります。
<project>
...
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-plugin-plugin</artifactId>
<version>2.5.1</version>
</plugin>
</plugins>
</reporting>
...
</project>
これにより、「プロジェクト レポート」リンクがサイト メニューに追加され、Maven プラグインの Javadoc に相当するものが表示されます。
すぐに使用できるようにmvn site
、少なくともインデックス ページを生成し (そしてプロジェクトの POM から と を活用)、基本的なレポート セット (About、Issue Tracking、Project Team、Dependencies、Project Plugins、Continuous Integration、Source Repository) を生成する必要がありname
ますdescription
。 、プロジェクト ライセンス、メーリング リスト、プラグイン管理、プロジェクトの概要)。
レポートのセットをカスタマイズする場合は、Maven プロジェクト情報レポート プラグイン(reporting
セクション内) を構成して、必要なレポートのみを含めることができます。
<project>
...
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-project-info-reports-plugin</artifactId>
<version>2.2</version>
<reportSets>
<reportSet>
<reports>
<report>dependencies</report>
<report>project-team</report>
<report>mailing-list</report>
<report>cim</report>
<report>issue-tracking</report>
<report>license</report>
<report>scm</report>
</reports>
</reportSet>
</reportSets>
</plugin>
...
</plugins>
</reporting>
...
</project>
サイトをカスタマイズする場合は、サイト記述子(src/site/site.xml
既定) を指定する必要があります。その場合、<menu ref="reports"/>
上記のレポートのエントリを含める必要があります。
コンテンツを追加する場合は、サポートされている形式 (APT、FML、XDoc など) のいずれかを使用して提供する必要があります。現在、ほとんどの場合、APTが使用されています。
詳細については、 Maven サイト プラグインのドキュメントを確認してください。
何も生み出さない?それは奇妙なことです。少なくとも、一般的な情報と依存関係のドキュメントを備えた非常に基本的なサイトを構築する必要があります。maven site
正しい呼び出しです。
追加のドキュメント (javadoc、テスト レポートなど) については、ビルド ファイルにさらに要素を追加する必要があります。いくつかの例については、確実なプラグインのドキュメントをご覧ください。
いいえ。ただし、ここに示すように、プロジェクトには特定の構造が含まれている必要があります。