xdoc和apt格式的比较优势

Question

xdoc 和 apt 格式用于编写 Maven 项目网站的相对优点是什么？其中一个比另一个更具表现力吗？其中一个比另一个获得更好的工具支持吗？

Answer 1

XDOC 格式绝对是一种更丰富的文档创建机制，如果您想生成带有 TOC/TOF、页眉、页脚或脚注（以及其他文档属性）的文档，则需要 XDOC 格式，因为 APT 格式不支持这些。

话虽这么说，我倾向于对几乎所有内部​​文档使用 APT 格式，因为我喜欢用 APT 格式编写。与编写 XDOC（及其 XML 的可爱之处）相比，APT 是轻而易举的事情。出于同样的原因，当我编写生成内容的插件时，我倾向于使用 XDOC 格式，因为编写创建所需 XML 的软件非常容易。

Answer 2

APT格式易于使用。但是，它不支持自定义样式（例如，为字符或标题设置样式）。与APT一起使用的最接近预先格式化的文本是“逐字文本”。 与HTML一样，逐字格式文本已预先格式化。与HTML不同，逐字文本被转义：在逐字显示内部，APT处理器不会解释标记。