xdoc形式とapt形式の比較の利点

Question

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

Answer 1

XDOC形式は間違いなくドキュメントを作成するためのより豊富なメカニズムであり、TOC / TOF、ヘッダー、フッター、または脚注（およびその他のドキュメント属性）を含むドキュメントを作成する場合に必要です。APTフォーマットはこれらをサポートしません。

そうは言っても、私はAPT形式で書くのが好きなので、ほとんどすべての内部ドキュメントにAPT形式を使用する傾向があります。 XDOC（すべてのXMLの魅力）を書くことに比べると、APTは簡単です。同様に、コンテンツを生成するプラグインを作成するときは、XDOC形式を使用する傾向があります。必要なXMLを作成するソフトウェアを作成するのは非常に簡単だからです。

Answer 2

APT形式は使いやすいです。ただし、カスタムスタイリング（たとえば、文字や見出しのスタイリング）はサポートしていません。 APTで使用できる書式設定済みのテキストに最も近いのは、「逐語的テキスト」です。 HTMLと同様に、逐語的テキストは事前にフォーマットされています。 HTMLとは異なり、逐語的テキストはエスケープされます。逐語的ディスプレイ内では、マークアップはAPTプロセッサによって解釈されません。