xdoc和apt格式的比較優勢

Question

用於編寫Maven項目網站的xdoc和apt格式的相對優點是什麼？比另一個更有表現力嗎？有人比其他人有更好的工具支持嗎？

Answer 1

XDOC格式絕對是一種創建文檔的更豐富的機制，並且如果您希望使用TOC/TOF，頁眉，頁腳或腳註（以及其他文檔屬性）生成文檔，XDOC格式是必需的，因爲APT格式不支持這些格式。這就是說，我傾向於將APT格式用於幾乎所有的內部文檔，因爲我喜歡以APT格式書寫。與編寫XDOC（具有所有XML可愛性）相比，APT是一件輕而易舉的事情。同樣，當我編寫生成內容的插件時，我傾向於使用XDOC格式，因爲編寫能夠創建所需XML的軟件非常簡單。

Answer 2

APT格式易於使用。但是，它不支持自定義樣式（例如樣式化字符或標題）。最接近可用於APT的預格式文本是「逐字文本」 與HTML一樣，逐字文本也是預格式化的。與HTML不同，逐字文本被轉義：在逐字顯示中，標記不被APT處理器解釋。