問題タブ [maven-javadoc-plugin]

プロジェクトをコミットした直後に、プロジェクトの Javadoc ファイルを SVN サーバー上に作成したいと考えています。つまり、サーバーに作業を任せたいということです。

すでにmaven-javadoc-plugin の例のセクションを調べましたが、適切な解決策が見つかりませんでした。(多分私はそれを理解していなかった、私はMavenに不慣れです。もしそうなら、寛大に私に説明してください)

パフォーマンスが大幅に低下するため、すべてのビルドで Maven に Javadoc を生成させたくないことに注意してください。それが<reporting/>正しい場所であるはずです。

Java EE 開発者向けの Eclipse IDE と Maven 3 を使用しています。

前もって感謝します

Maven Release Plugin Plugin を使用して、Jenkins ジョブでマルチモジュール Maven リアクター プロジェクトの集計Javadocを生成する絶対確実な方法はありますか?

私の問題は、 がすべての POM バージョンを更新した後、モジュール アーティファクトの参照バージョンがまだ存在しない場合、リアクター POM で失敗maven-release-pluginするため、次のビルドが壊れることです。javadoc:aggregate

maven-javadoc-plugin私の回避策は、プロファイルを使用して、無効にしてビルドを 1 回実行することです。次に、再度有効にするとmaven-javadoc-plugin、次のビルドが成功します。

これはむしろハックであり、単純なものが欠けているだけなのだろうか...

maven-javadoc-pluginこれがリアクター POM からの私の構成です。

私はPDFDocletwithmaven-javadoc-pluginを使用していますが、今ではかなり長い道のりを歩んできました。私はmavenとjavadocの構成をほぼ十分な時点で持っていますが、私の差し迫った問題は、プロジェクトのバージョン番号をPDFのタイトルページにプッシュする方法を理解できないことです。

Maven のフィルタリングを使用するように指示して私の質問に答える前に<resource>、それが機能しない理由を概説しましょう。

フィルタリングは、srcフォルダー内のどこかから元のファイルを取得し、変数置換を実行して、出力をtargetフォルダーに配置することによって機能します。

Javadoc は と でファイルを読み取りsrc/main/java、src/main/javadocAFAIK が結果を に出力することで機能しtargetます。これは、Javadoc から何も読み取らないため、フィルタリングが役に立たないことを意味します。target

私の結果は、javadoc コメント内のどの Maven 変数も置換されないことを示しています。

これらの変数を javadoc に代入するには、どのようなトリックを使用できますか?

リソースのフィルタリングが PDF で機能しない限り、この解決策では、site:site タスクの後に javadoc 出力をフィルタリングすることはできません。

これは構成です、FWIW:

そしてpdfdoclet.properties：

PDFDoclet固有のapi.*プロパティにより、タイトル ページが PDF の最初のページになるはずですが、機能しません。ここで見逃したトリックがあり、そのタイトル ページを生成できた場合、これも何らかの形で解決できる可能性があります。

私は Derby の Maven ビルドにいくつかの javadoc jar を吐き出すよう強制して、それらをリポジトリーに含めることができるようにしようとしています。

正しいターゲットのように見えるものを実行しようとしました：

しかし、私が得るのはエラーだけです:

OK、ビルドderbynetは に依存します。それで問題derbyありませんが、リポジトリの jar を使用する必要がある理由がわかりません。代わりに実行mvn packageすると、Javadoc のコンパイルとビルドには同じ依存関係要件がありますが、それは機能します。

では、なぜ機能しないjavadoc:jarのでしょうか。

Maven Javadoc プラグインとカスタム ドックレットに問題があります。

私はmaven-javadoc-plugin v 2.10.1と、基本的にmaven jarプロジェクトであるカスタムドックレットを使用しています。

リポジトリをカスタム成果物にsettings.xml定義するもあります。central

問題は、maven-javadoc-plugin を実行するたびに、カスタム ドックレットの依存関係を から解決しようとすることhttps://repo.maven.apache.org/maven2です。ドックレット自体は、カスタム アーティファクトから解決されます。
デバッグ出力も非常に奇妙で、centralリポジトリは私のカスタム スナップショット アーティファクトであると表示されます。 maven-jar-plugin が のリポジトリを上書きするようにロックします。https://repo.maven.apache.org/maven2snapshot
centralsettings.xml

リポジトリmaven-jar-pluginを上書きしないようにするにはどうすればよいですか。central

デバッグ ログは次のようになります。

30000 文字しかないため、いくつかのスタック トレースと、できれば不要なデバッグ ログをカットする必要があります。

これは、maven-javadoc-plugin の構成を持つ親 POM です。

更新：これが私のものですsettings.xml

この問題で私を助けてくれる人がいることを願っています。

よろしく

クラス、パッケージのカスタマイズされたjavadocを生成するにはどうすればよいですか?

maven-pdf-plugin と pdfdoclet を使用して多くの方法を試しましたが、失敗したか、間違った方法でやりましたか? アドバイスをいただけますか？またはいくつかのガイド、いくつかのチュートリアル?...

前もって感謝します

パッケージcom.axonivy.compensation.entityのjavadoc全体を抽出して、すでに試したmavenをhtmlにする私のターゲット：

または、この方法に従ってください https://maven.apache.org/plugins/maven-javadoc-plugin/examples/group-configuration.html

しかし、それでもうまくいきません。パッケージ com.axonivy.compensation.entity だけでなく、プロジェクト全体の javadoc が抽出されるようになりました。

誰でもそれについて何か考えがありますか？ありがとう

ツールチェーン プラグインをデフォルト プロファイルでアクティブに定義すると、maven-javadoc-plugin などの一部のプラグインでは機能しません (maven-compiler-plugin の場合は機能します)。

それ以外の場合は、すべてのプラグインで完璧に機能します:

なぜこうなった？