Avantages comparatifs des formats xdoc et apt

Question

Quels sont les avantages relatifs des formats xdoc et apt pour la rédaction de sites Web de projets Maven? Est-ce que l'un est plus expressif que l'autre? L’un at-il un meilleur support que l’autre?

Answer 1

Le format XDOC est certainement un mécanisme plus riche pour la création de documents. Il est indispensable si vous souhaitez produire des documents avec TOC / TOF, en-têtes, pieds de page ou notes de bas de page (et autres attributs de document), car le format APT ne les prend pas en charge.

Cela dit, j’ai tendance à utiliser le format APT pour presque tous les documents internes, car j’aime écrire au format APT. Comparé à l'écriture de XDOC (avec toute sa beauté XML), APT est un jeu d'enfant. De même, lorsque je rédige un plugin qui génère du contenu, j’ai tendance à utiliser le format XDOC, car il est assez facile d’écrire un logiciel qui crée le code XML requis.

Answer 2

Le format APT est facile à utiliser. Cependant, il ne prend pas en charge le style personnalisé (par exemple le style d'un caractère ou d'un en-tête). Le texte le plus proche que vous pouvez utiliser avec APT est le texte "textuel". Comme en HTML, le texte textuel est préformaté. Contrairement au HTML, le texte textuel est échappé: dans un affichage textuel, le balisage n’est pas interprété par le processeur APT.