問題タブ [maven-site-plugin]

アプリケーション開発の一環として、Maven サイト プラグインを使用してドキュメントを作成しています。apt ファイルは にありますsrc/site/apt。{{xxx}} 構文を使用して apt でリンクを作成できることは知っていますが、Java ファイルおよび/またはパッケージへのリンクを作成する簡単な方法があるかどうか疑問に思っていましたか?

相対パス (例: ../../main/java/com/pkg/MyFile.java) を使用する唯一の方法はありますか?

パッケージ名にリンクする方法はありますか?

初めてmaven checkstyleプラグインを使用しています。親 pom に checkstyle プラグインを追加し、checkstyle.xml でいくつかのルールのリストを指定しました。

レポートを生成するために「mvn clean site」を実行しています。すべてが正常に機能していますが、不要なレポートも多数生成されています。どうすれば防ぐことができますか。

「mvn clean checkstyle:checkstyle」を試しましたが、checkstyle.xml ルールを考慮していません。すなわち。すべてのデフォルト ルール違反のレポートも生成しています。

また、Web ページも適切に表示されません。すなわち。スタイル（.cssファイル）なしで.htmlファイルを生成するため、見た目が非常に悪くなります。

私のpom.xmlには

プロジェクトのサイトを生成するために maven-site-plugin を使用しようとしています。今のところ、プラグインを追加したばかりmvn siteで、マルチモジュール プロジェクトのルートから実行しています。

を実行するたびに、ログに次のエラーが表示されますmvn site。

このUnable to connect toメッセージは、ログで何十回も繰​​り返されます。

プロジェクトの pom はここにあります: https://github.com/justinhrobbins/FlashCards_App ですが、上記のように、プラグインを maven-site-plugin の pom に追加しました。

これらのエラーが表示されますが、ビルドは成功し、生成されたサイトの依存関係の収束ページに依存関係が表示されます。

エラーをグーグルで検索しようとしましたが、同じエラーの CI ビルド ログがいくつか見つかりました。

Jenkins で実行できる 1 つのコマンドで、マルチモジュール プロジェクトの完全なサイトを構築しようとしています。ただし、ビルドすると、サブモジュールの javadocs がサイト ルート (site/submodule/apidocs ではなく site/apidocs) に表示されます。親からサブモジュールへのリンクもすべて壊れています。

組織が基準

親 POM には以下が含まれます。

サブモジュール POM には、pluginManagement のスケルトン プラグイン定義が含まれているだけです。

サイトを構築しようとすると (ローカル マシンと Jenkins の両方で)、親から実行します

上記の設定で、サブモジュールがそのサイト ファイルをサブモジュール ディレクトリ (site/submodule) ではなくサイト ルート (site/) にダンプする原因は何ですか? スタング コマンドを使用する必要がありますか (リリース プロセスが中断されるため、使用を避けています)。1 つのコマンドでマルチモジュール サイトを構築することは不可能ですか?

私は現在、maven サイトプラグインに苦労しています。すべての依存関係バージョンを定義し、サイト プラグインも構成する企業/スーパー pom (パッケージ タイプ pom) があります。さらに、カスタムの site.xml で参照される /src/site/resources/images の下にいくつかの画像リソースを配置しました (./images/logo.jpg など)。

別のモジュールがこの親 pom を参照しており、mvn サイトを呼び出すと、site.xml が取得されているようです。残念ながら、画像へのリンクは機能しません。target/site フォルダを見てみると、画像がありませんでした。また、追加の「企業」リソース モジュールを作成して、サイト リソース (/src/site/resources の下) を配置し、このモジュールを次のように maven-site-plugin の依存関係として参照しようとしました。

しかし、これもうまくいかないようです。/src/main/resources の下に配置された特別な構成を持つ pmd などの他のレポート モジュールでは機能しましたが、サイト リソースがピックアップされてリポジトリに公開されていないようです。

問題は、画像とスタイルシートを Maven スーパーポンに添付するにはどうすればよいかということです。私はMaven 3を使用しています...

次のような構造の 3 レベルのマルチモジュール maven プロジェクトの Maven サイトを作成しています。

私は走っていますmvn site site:stage

Maven サイト モジュール リンクは child-a では機能しますが、ネストされたモジュール child-b では機能しません。(最初に child-a へのリンクをクリックすると、child-b へのリンクが機能します。)

ここで自分の目で確かめてください: http://justinhrobbins.github.io/multi-module-site-report-test/site/0.0.1-SNAPSHOT/

親pomには次のものがあります：

この Maven サイト レポートのすべてのプロジェクト モジュールでリンクが機能するには、何をする必要がありますか? (私<url>はそれが現実ではないことを知っています, 今のところ私はそれがステージで機能することを望みます)

問題を示す簡単なテスト ケース プロジェクトを Github に追加しました: https://github.com/justinhrobbins/multi-module-site-report-test

編集:私は次のプラグインのバージョンを使用しています:

親 POM ファイルとサブモジュールを使用して Maven サイトを構築することについて質問があります。メニューが親 POM から継承されている場合、継承されたモジュール サイトで相対リンクを取得するのに問題があります。

次のようなプロジェクト構造があります。

したがって、この構成では、次のようなサイトになります。

modules/pom.xml からのリアクター ビルドは最上位の Web サイトを生成し、各モジュールにはサイトも生成されます。

各モジュールは、この site.xml ファイルを親から継承します (例):

標準の Maven 生成「レポート」を参照するメニューは正常に機能します。

しかし、project-summary.html への href は、子サイトではなくトップ サイトを指すことになります。

継承されたメニューの構築に関連する Stackoverflow に関する同様の問題をいくつか見てきましたが、これらのリンクを親サイトではなく子サイトのコンテンツを指すようにする方法に関する正確な情報は見つかりませんでした。ここでメニューの継承が何を達成することになっているのか、私が誤解している可能性があります。

基本的に、子サイトで生成されたコンテンツへのメニュー リンクを次のようにしたいと考えています。

さて、次のようなものを使用して、親POMからこれを達成するためにフィルタリングを使用してみようと思いました:

ただし、子プロジェクトの名前の代わりに親 POM の名前がここで置換されるため、これは機能しません。

この場合、モジュールごとにカスタムの site.xml を配置する必要があるかもしれませんが、15 個ほどあるため、これは避けたいと思います。それらは、約 8 または 9 個の異なる (相対) メニュー リンク。ほとんどのプロジェクトでは、独自の site.xml ファイルは必要ありません。したがって、理想的には、いくつかの追加メニューを追加する子 POM を使用して、すべてのデフォルトを親に定義してもらいたいと考えています。

これを行うために、「レポート」参照とそのデフォルト レイアウトを使用することに固執していますか? または、これらを親の site.xml ファイルのメニュー項目として明示的にリストし、それらの参照を何らかの形で機能させることはできますか?

それが明確であることを願っています。ありがとう。