maven-2 - xdoc形式とapt形式の比較優位

Question

MavenプロジェクトのWebサイトを作成するためのxdocおよびapt形式の相対的なメリットは何ですか？一方はもう一方よりも表現力がありますか？一方が他方よりも優れたツールサポートを得ていますか？

Answer 1

APT 形式はこれらをサポートしていないため、TOC/TOF、ヘッダー、フッター、脚注 (およびその他のドキュメント属性) を含むドキュメントを作成する場合は、XDOC 形式の方が間違いなくドキュメントを作成するためのより豊富なメカニズムです。

そうは言っても、私は APT 形式で書くのが好きなので、ほぼすべての社内文書に APT 形式を使用する傾向があります。XDOC (XML のすべての魅力を備えた) を作成する場合と比較すると、APT は簡単です。同様に、コンテンツを生成するプラグインを作成するときは、XDOC 形式を使用する傾向があります。必要な XML を作成するソフトウェアを作成するのは非常に簡単だからです。

Answer 2

APT 形式は使いやすいです。ただし、カスタム スタイリング (文字や見出しのスタイリングなど) はサポートしていません。APT で使用できる整形済みテキストに最も近いのは、「verbatim テキスト」です。HTML と同様、verbatim テキストは整形済みテキストです。HTML とは異なり、逐語テキストはエスケープされます。逐語表示内では、マークアップは APT プロセッサによって解釈されません。