xdoc和apt格式的比较优势

Question

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

Answer 1

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

也就是说，我倾向于对几乎所有的内部文档使用APT格式，因为我喜欢用APT格式编写。与编写XDOC (及其所有的XML特性)相比，APT轻而易举。出于同样的原因，当我编写生成内容的插件时，我倾向于使用XDOC格式，因为编写创建所需XML的软件非常容易。

Answer 2

APT格式易于使用。但是，它不支持自定义样式(例如，设置字符或标题的样式)。与APT一起使用的最接近预格式化的文本是"verbatim text“，就像在HTML中一样，verbatim text是预格式化的。与HTML不同，逐字文本是转义的:在逐字显示中，APT处理器不解释标记。