1

Maven サイト プラグインを使用してプロジェクト ドキュメントを生成したいと考えています。「プロジェクト情報」と「プロジェクト レポート」のデフォルトのレイアウト、構造、および機能は、私にとっては問題ありません。しかし、プロジェクトにそのようなドキュメントがある場合、追加の（3番目の）セクション「追加ドキュメント」を追加したいと思います。これは、さらにいくつかのドキュメントにリンクしています。

ディレクトリを作成する と、必要に応じsrc/site/resources/otherDocuてドキュメントがディレクトリにコピーさ target/site/otherDocu れます。ただし、生成されたサイトはそれらにリンクしていません。

上記のディレクトリ内のファイルをリストしてリンクする 3 番目のセクション「追加ドキュメント」を希望します。できるだけ小さなオーバーヘッドでこれを行いたいです。site.xml具体的には、回避できる場合は、多くのソリューションで説明されているように、css などと一緒にown を含めたくありません。デフォルトのサイト構成を使用して、一部のみを「注入」するにはどうすればよいですか? site.xmlまたは、これが唯一の方法である場合、親POMで1回だけファイル（たとえば）を構成し、それを他のすべてのプロジェクトに継承できるはずです。src/site/resources/otherDocuで見つかったファイルを一覧表示し、それらへのリンクを表示するにはどうすればよいですか?

または、私が考えていたこと：これを行う独自のレポートプラグインを作成でき、他のレポートプラグインの場合と同様に、POM の「レポート/プラグイン」セクションでこのプラグインを指定するだけで済みます。 . このソリューションを使用すると、他のすべてのレポート プラグインと同様に、「プロジェクト レポート」セクションに追加のエントリを作成できる可能性があります。これは正しい方向への一歩です。しかし、いくつかのエントリが必要です (リンクされたドキュメントが複数あるため)、またはサブエントリを含む 1 つのエントリ "Additional docu" が必要です。

行きやすいのはどっち？推奨事項または同様の解決策はありますか? site.xmlすでにいくつかのリストを作成し、他のすべてのリソース (画像など) を必要とせず、継承できるファイル (または類似のもの) を持っている人はいますか?

4

2 に答える 2

1

デフォルトの動作を維持するための最初のことは、サイト記述子で何かを使用することです。

  <body>
     <menu ref="reports"/>
     <menu ref="modules"/>
  </body>

docs で読むことができるように、ファイルをターゲットに自動的にコピーするために使用しているものはリソースに想定されています。

さらに、自動的に作成されたドキュメントには、レポート プラグインを経由する必要があります。

于 2015-01-07T08:57:33.747 に答える