私は、pdf および html 5 形式のドキュメントを変更するために、簡単に保守可能で見栄えの良いものを作成して構築する必要があります。ソース形式は編集しやすいものにする必要があります。この Maven プラグインは、私の会社の組織テーマ (フォント、色、画像など)、TOC 生成、異なるファイルへの章の分離、画像ファイルの統合、コード スニペットをドキュメントに簡単に挿入する方法をサポートする必要があります。私はMavenビルドを持っていますが、それを行うための現在の最善の決定は何ですか?
私は2つのオプションを調査していました：
- Doxia - 入力形式として md(markdown) を使用。WSWG md フリー エディターがあり、多くの前述の機能をサポートしています。そのアーティファクトには外部レポが必要です。
- Asciidoctor - asdcii doc を入力形式として使用します。フラグメントなどを使用したテンプレート化をサポートします。
このプラグインを使用する利点と欠点は何ですか? 他に良い解決策はありますか？