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