maven-2 - 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 处理器解释。