As vantagens comparativas de xdoc e formatos apt

Question

Quais são os méritos relativos do xdoc e formatos aptos para escrever sites de projetos Maven? É uma mais expressiva do que a outra? Tem um tem um suporte melhor ferramenta que o outro?

Answer 1

O formato xdoc é definitivamente um mecanismo mais rico para criação de documentos e é necessário se você quiser produzir documentos com TOC / TOF, cabeçalhos, rodapés ou notas de rodapé (e outros atributos do documento), uma vez que o formato APT não suporta estes.

Dito isto, eu tendem a usar o formato APT para quase todos os documentos internos como eu gosto de escrever no formato APT. Quando comparado a escrever xdoc (com toda a sua beleza XML), APT é uma brisa. Da mesma forma, quando estou escrevendo um plugin que gera conteúdo, que tendem a usar o formato xdoc, já que é muito fácil de escrever software que cria o XML necessário.

Answer 2

formato APT é fácil de usar. No entanto, ele não suporta estilo personalizado (por exemplo denominar um personagem ou um título). O mais próximo de texto pré-formatado que você pode usar com o APT é o "texto literal" Como em HTML, texto literal é pré-formatado. Ao contrário de HTML, texto literal é escapado: dentro de uma exibição na íntegra, a marcação não é interpretado pelo processador APT

.