問題タブ [maven-site-plugin]

カスタム Maven 3 プラグインからいくつかの Maven サイト コンテンツを生成したいと考えています。これを行う方法に関するドキュメントを見つけることができませんでした。

Maven のような方法でコンテンツを作成し、生成サイトに追加するにはどうすればよいですか?

Maven は、サイトのコンテンツ生成を支援するためにどのような機能を提供していますか?

これを支援するための適切なドキュメント/例はありますか?

私はMavenプロジェクトの深い階層を持っています。最上位プロジェクトは純粋な集約プロジェクトです。依存関係自体を定義せず、それぞれに多くの依存関係を持つ子プロジェクトを列挙するだけです。

各プロジェクトの依存関係レポートを取得する方法を知っています。問題は、情報が上位プロジェクトに自動的に伝播されないことです。たとえば、プロジェクト "Base" と 2 つのサブプロジェクト "One" と "Two" がdependenices.htmlある場合、子プロジェクトごとに依存関係レポート ( ) を表示できますが、ベース プロジェクト レベルの合計レポートは表示されません。

そのようなレポートを達成する方法はありますか？私の現在の回避策は、すべての「dependencies.html」ファイルを解析して合計レポートを作成するプログラムを作成することですが、そのようなコードを実装するには数時間かかります。

他の解決策はありますか？基本プロジェクトがその子プロジェクトのすべてのライブラリに依存することを pom で定義することはおそらく可能ですか?

Mavenサイトプラグインを使用して、製品のサイトを生成します。サイトの新しいバージョンや新しいページについてユーザーに通知するRSSストリームを生成する機能はありますか？

私は次のmaven-setupを持っています：

親では、すべての依存関係とプラグイン管理、および開発チームに関する情報を定義します。Web サイトのスキンや checkstyle-config などの機能的なアーティファクトを含むユーティリティ、ライブラリは、依存関係を簡素化するためのバンドル アーティファクトです。このサイトは、コア モジュールとそのサブ モ​​ジュールで構築されています。コア pom の親部分。

サイトをステージングまたはデプロイする場合、ページは「コア」サブディレクトリ (例: /target/staging/core/index.html) に配置されます。ルートでコアのサイトを見つける方法はありますか?

Atm 私は「汚いハック」を使用します。Webサーバーでsyslinkを作成したln -s ./ coreので、彼は同じディレクトリを知りません。

私はmaven3を使用しており、新しいmaven 3 siteplugin+javadoc構成に従ってjavadocを構成しています。ただし、私のjavadoc構成パラメーターはすべて無視されているようです。したがって、パッケージのグループ化やソースのリンクなどはありません。

私のプロジェクトはマルチモジュールプロジェクトです。使用するコマンドは次のとおりです。mvn3cleanpackagejavadoc：aggregate

これが私のルートpomの関連部分です。

サイトを生成したいカスタムMavenプラグインがあります。このサイトの唯一の目的は、プラグインの利用可能な目標を自動的に文書化することです。ただし、を実行するmvn clean siteと、plugin-info.htmlファイルが生成されません。

このモジュールのパッケージがであるとするmaven-pluginと、これはサイトプラグインによって自動的に作成されると思いました。サイトプラグインの目標を調べて、これを明示的に「オン」にする必要があるかどうかを確認しましたが、何かが見つかりました。plugin-info.htmlを強制的に作成するために欠けているものはありますか？

使ってます：

• Maven 3.0.3
• maven-site-plugin 3.0

カスタム ドックレットを使用してカスタム javadoc タグからレポートを生成し、Maven サイト プラグインと javadoc プラグインを使用して、このレポートと通常の Java API ドキュメントの両方を生成します。

POM のセクションは次のようになります。

Maven 2 ではこれで問題なく動作しますが、Maven 3 では 1 つのレポートのみが生成され、POM で指定された最後のレポートになります (reportSet要素を交換することによって確認されます)。

いくつかの実験の後、通常のレポートの目標を「javadoc」から「test-javadoc」に変更すると、両方のレポート セットから出力が得られることがわかりました。したがって、Maven 3 では、同じ javadoc-plugin ゴールを使用する 2 つのレポートを生成できないことが問題のようです。

これはバグですか、それとも私が見逃した設定がありますか? http://maven.apache.org/plugins/maven-site-plugin-3.0-beta-3/maven-3.htmlで説明されているように、maven-javadoc-plugin セットアップをサイト プラグインの から に移動しreportingましconfigurationた。役立たず。Maven 3.0.4、maven-site-plugin 3.0-beta-3、maven-javadoc-plugin 2.8.1 を使用しています。

ありがとう！

マルチモジュールプロジェクトがあり、親pomには、いくつかのレポートプラグインが定義されています。一部のモジュールには、レポートプラグインを実行する必要のないコードが含まれているため、生成されたサイトに含める必要はありません。親pomレベルでそれらを無視するようにMavenに指示する方法はありますか？

アップデート：

ajozwikの回答に基づいて、スキップ構成を追加しました。私のPOMは次のようになります...

client / pom.xml

私が実行するとき：

ビルドは成功し、クライアントのターゲットディレクトリには生成されたサイトが含まれていません。私が走るとき：

サイトをステージングするために、サイトを正しくステージングします。skipDeployタグがないと、ステージングは​​失敗します...

マルチモジュール アプリケーションがあり、このアプリの Maven サイトを生成しようとしています。

すべての子モジュールを保持する集約 POM、子モジュールのすべての共通機能を保持する継承 POM、および 20 ほどの子モジュールがあります。

これを機能させる方法の無限のオンライン例を繰り返しました。これらのいずれにおいても、この作業のマルチ モジュール部分は実行されません。子 (および集約モジュール) のターゲット/サイト フォルダーで、個々のサイト出力を正常にビルドできます。また、集約POMのターゲット/ステージングフォルダーにステージングしました。出来上がったものは良さそうです。

しかし：

子モジュールのリンクはどれも機能しません。

この問題に関するいくつかのコメントは、リンクが Web サイトとして構築されている場合にのみ機能すると述べているため、これを jetty の下で実行しようとしましたが、同じ問題で、子の index.html が見つかりません。

誰かがこの作業の例を持っていますか? そして、私がこれ以上髪を引き裂くのを避けるために（神はそれがそのままそこにあることを知っています）、実際に機能するPOMコードおよび/または正しいテストと展開に続く段階を見たいと思います.

誰でも助けることができますか？