問題タブ [maven-site-plugin]

gh-pagesMaven を使用して、Maven で生成されたサイトをgit リポジトリのブランチに自動的にデプロイするいくつかのプロジェクトのセットアップに成功しました。次に、GitHub はこれらのファイルを個人用サブドメインのパブリック URL で提供します。この機能を利用して、リッチなクライアント側のみの GWT アプリケーションを提供したいと考えています。

GWT アプリケーションをディレクトリpom.xmlにコンパイルするように変更しました。target/site/私がまだ達成しようとしている2つの主な目標は次のとおりです。

• siteフェーズ中に標準の Maven サイト プラグインが実行されないようにするにはどうすればよいですか?
• フェーズgwt:compile中に実行するために必要なものは何ですか?site

いくつかのモジュールを含むMaven管理のプロジェクトがあり、そのうちの1つは実際の対象ライブラリです。他のモジュールは、ライブラリから構築された単なるアドオンまたは例です。このライブラリのMavenサイトを生成し、自動的にデプロイすることを検討しています（マルチモジュールサイトの一部としてではなく、スタンドアロンサイトとして）が、Javadocプラグインに問題があります。

ゴールを実行するとき、javadocプラグインは他のモジュールjavadoc:javadocのにアクセスしようとして失敗を引き起こします。jar

この現象を示す簡単な例を作成しました。clean欠陥が表示されるように、他のどのゴールよりも先にゴールを実行するようにしてください。最初にパッケージを実行することでこのエラーを解決できますが、クリーンな状態から開始するMaven管理のリリースプロセス中にユースケースが発生するため、これを行うことはできません。

javadocプラグインでこの機能を無効にして、ライブラリモジュールのドキュメントのみを取得する方法はありますか？

アプリケーションのサイトを作成するためにMavenを使用したいと思います。これはマルチモジュールアプリであり、親モジュールは単純なサイトモジュールであり、最初の子はアプリのコアであり、2番目はGUI（Swing）です。

私は今、親pom.xmlにfollowを使用しています

私のコアのpom：

（私は両方から無関係な部分を取り除きました）

問題：mvn site：stageを試しましたが、コアモジュールからjavadocが収集されません。何が間違っていますか？

多くのサブモジュールを含むMavenプロジェクトがあり、親pomを使用して、以下のようなディレクトリのプラグインを制御します

したがってsrc\site\site.xml、以下のようなカスタマイズされたメニューが含まれています

mvn site:stageルートで実行した後( Maven サイト プラグインから推奨)、親 Web ページは問題あり<sub-modules>\index.htmlませんが、メニューは含まれていません (プロジェクト情報とプロジェクト レポートはありません)。

またmvn site、サブモジュールの下で実行すると、index.html には左側にメニューが含まれていないことに気付きますが、個々の html は pmd.html、license.html などのディレクトリに存在します。

• src\site\site.xml各サブモジュールまたは他のより良い方法を追加する必要がありますか?
• または私はpom.xmlどこかで愚かなことをしましたか？

ヒントはありますか？

【更新】バナー画像も同様、親に設定するとこんな風に

間違った方向へのポイントを含むサブモジュールのサイトは、HTML では、のように見えますが、そう..\..\<submodule>ではありません..\images\mylogo.png

Maven（バージョン3.0.3）のサイト配布機能を使用して、プロジェクト用に生成されたコンテンツをアップロードしています。これは、pom.xmlで次のように構成されています。

正常に動作しますが、ページの「最終公開日：」の部分は、ターゲットフォルダーのコンテンツを物理的に削除した場合にのみ更新されることに気付きました。これがバグかどうか疑問に思っています。バグがある場合は、アップロードされたファイルを解凍して回避​​する前に、ターゲットフォルダーをクリーンアップするようにmaven-site-plugin（バージョン3.0-beta-3）を構成することは可能でしょうか。 ？

どんな助けでも大歓迎です。

スナップショットとリリース (つまり、リリースの場合はhttp://example.org 、スナップショットの場合はhttp://dev.example.org ) で異なる Maven プロジェクトの階層のサイトをデプロイし、プロジェクト階層 (親、子、モジュール) 適切なリンクで修正します。

私の試みは、「現在の」サイト情報を保持するためのプロパティと、考えられる各タイプのサイト (dev、stable など) を保持するためのプロパティを割り当てることでした。次に、プロファイルを使用して、リリース時にサイト情報を切り替えます。以下は、私が言いたいことの例です。

親 POM スニペット:

親サイト記述子の例:

子サイト記述子の例:

これの配布管理部分は完全に機能し、期待どおりにファイルを展開します (アクティブなプロファイルに基づいて、ターゲット マシンの適切なディレクトリに)。

実際のサイト パーツの場合:

サイト プラグインのバージョン 2.2 では、これは親サイトでは正常に機能しますが、指定されたリリース プロファイルがアクティブであっても、すべての子孫サイトはスナップショットまたは「開発」バージョンに戻ります。サイト プラグインのバージョン 3.0 では、次のメッセージが出力され、(前述のように) 親メニューは作成されません。リンク セクションはバージョン 2.2 のように機能します。

codehaus の properties-maven-plugin を使用すると、プロファイル プロパティが正しく適用されていることがわかりますが、サイト プラグインはこれを無視しているようです。

私がやろうとしていることを達成するためのより良い方法はありますか? これはバグですか、それともどこかで間違いを犯しましたか?

私は現在、 Maven3を使用してmaven-site-pluginを使用しています。

プラグインは期待どおりにすべてのレポートを生成していますが、私のプロジェクトレイアウト（以下に表示）のため、表示されるメインサイトにはレポートが表示されません。誰かがコンテンツを共有する方法をアドバイスしたり、リンクをsite.xmlに入れてコンテンツを表示する方法を示すためにリンクを追加したりできますか？ありがとう

site\site.xmlファイルは次のようになります。

サイトの実行は問題ありません。サイトは表示されますが、リンクは機能せず、レポートは表示されません。これは、私のプロジェクトの設定が標準ではないためだと思います。私は次の設定をしています

なんらかの理由で、site：runを実行して「localhost：8080」と入力すると、PARENT_PROJECT \ target \ index.htmlファイルではなく、EAR \ target \ index.htmlのindex.htmlが表示されますか？

mvn：siteはPARENT_PROJECTから実行されることに注意してください

含めるようにPOMを変更しました

マルチプロジェクトとして、ここで提案されているようにsite：stageを実行していますhttp://maven.apache.org/plugins/maven-site-plugin/faq.htmlしかし、mavenが「What」と述べているため、プロジェクトを実行できないことに気付きました。マルチプロジェクトビルドでは、「mvn site」は、親とそのすべてのモジュールに対して個別に「mvn site」を実行します。ここでは、親と子の間のリンクは機能しません。ただし、サイト。"

ドキュメントとリソースのサイトを作成してデプロイするために、Maven サイト プラグインを使用しています。使用されているプロファイルに基づいてフィルタリングしたい JavaScript ファイルがいくつかあります。問題は、フィルタリングを機能させる方法がわからないことです。誰かがこれに出くわしましたか？

私は Maven 3 を使用しています。私のリソースはすべて、サイト プラグインによって/src/site/resources自動的にコピーされます。/target/site

ありがとう！

maven-site-plugin と maven-javadoc-plugin ( doclava docletを使用) を構成したので、 によって生成されたサイトで適切な JavaDoc を取得しようとしていますmvn site。私のコードには、いくつかの JUnit テスト クラス ( src/test/java/my/package/*.javaにあります) があり、これらの JavaDoc コメントはソース クラス ( src/main/java/my/package/*.javaにあります)にリンクしています。 . 問題は、Test JavaDoc を生成するときに、javadoc がソース クラスのドキュメントがどこにあるかを見つけられないことです。maven-javadoc-plugin の構成オプションを使用して、javadoc にそれを見つける場所を伝えようとしました (linksここに文書化されています)。offlineLinks）、しかし運が悪い。生成されたドキュメントをオフラインで表示するときに (ブラウザで/path/to/project/target/site/index.htmlを参照して)実行できるように、javadoc に相対リンクを生成してもらいたいと考えています。Test JavaDocs 生成を無効にしたくありません

私の pom.xml | mvn サイトの出力からの抜粋

また、私はJavaとMav​​enの初心者です

質問を明確にするために、ここに例を示します。src/test/java/name/earshinov/PrefixCircuits/GenerateATest.javaにテスト クラスGenerateATestがあります (コメントがロシア語で申し訳ありません)。

リンクされたクラスPrefixCircuitGeneratorはsrc/main/java/name/earshinov/PrefixCircuits/PrefixCircuitGenerator.java にあります。を実行するmvn siteと、ソース クラスのJavaDocs がtarget/site/apidocs/index.htmlに、Test JavaDocs がtarget/site/testapidocs / index.html に取得されます。Test JavaDocsのドキュメントでは、ソース クラス JavaDocsGenerateATestのドキュメントへのリンクを参照したいと思います。PrefixCircuitGeneratorただし、javadoc は参照先が見つからPrefixCircuitGeneratorないため、リンクを生成せず、対応する警告がmvn site出力に表示されます。

私の目的は、（どういうわけか）javadocにリンクの生成方法を伝えることです。に変更{@link name.earshinov.PrefixCircuits.PrefixCircuitGenerator}しても何も変わり{@link PrefixCircuitGenerator}ません。

これが私が直面している状況です。現在、2 つの Maven プロジェクトがあります。1 つは依存関係、リポジトリなどを記述することだけを行います (親)、もう 1 つは pom.xml を継承する子です。子と同じモデルに従って、将来さらに多くのモジュールが作成される予定です。

プロジェクトのサイト (maven-site-plugin で生成) を、現時点ではsftp経由でのみアクセスできる場所にデプロイすることにしました。また、sftp プロトコルを統合できなかったため、サイトの場所を定義することが不可能であることがわかりました<distributionManagement>(wagon-ssh-external を使用してみました)。

その結果、リモート マシンに接続し、サイト展開フェーズでサイトが展開されているローカル フォルダーの内容をアップロードするスクリプトを作成しました。

これは親サイトでは完全に機能し、ローカルで作成された直後にサイトをアップロードしますが、子がスクリプトの最後に到達すると、正しく終了せず、印刷さTerminating script execution..れてそこにとどまります。

デフォルトの Maven プラグイン (v. 3.0.2) を備えた最新バージョン (3.7) の Eclipse を使用しています。Eclipse でサイトを生成してデプロイするために、親プロジェクトを右クリックし、[Run as] > [Maven build...] > parent clean site-deploy.

これらは親の の一部ですpom.xml:

そして子供から：

execプラグインを構成するさまざまな方法を試しました(を使用せずpluginManagementに、プラグインの親の構成を継承し、引数部分のみを書き換えるなど)、スクリプトの終了時に常にブロックされ、実行を終了しません。

サイトは正しくアップロードされていますが、もちろん、サイトを更新するたびに Maven ビルドの実行を手動で終了したくはありません (また、プロジェクトから Jenkins サーバーにアーティファクトをデプロイする予定であるため、サイトはそれまでに展開が機能することを願っています)。