Сравнительные преимущества форматов xdoc и apt
Каковы относительные преимущества форматов xdoc и apt для написания веб-сайтов проектов Maven? Один выразительнее другого? Один получил лучшую поддержку инструмента, чем другой?
2 ответа
Формат XDOC, безусловно, является более богатым механизмом для создания документов и необходим, если вы хотите создавать документы с TOC/TOF, верхними, нижними колонтитулами или сносками (и другими атрибутами документа), поскольку формат APT не поддерживает их.
При этом я склонен использовать формат APT почти для всех внутренних документов, так как мне нравится писать в формате APT. По сравнению с написанием XDOC (со всей его прелестью XML), APT очень проста. Точно так же, когда я пишу плагин, который генерирует контент, я склонен использовать формат XDOC, поскольку довольно легко написать программное обеспечение, которое создает требуемый XML.
Формат APT прост в использовании. Однако он не поддерживает пользовательский стиль (например, стиль символа или заголовка). Наиболее близким к предварительно форматированному тексту, который можно использовать с APT, является "дословный текст" Как и в HTML, дословный текст предварительно отформатирован. В отличие от HTML, дословный текст экранируется: внутри стенографического отображения разметка не интерпретируется процессором APT.