Komparativen Vorteile von xdoc und apt-Formate

Question

Was sind die Vorzüge des xdoc und apt-Formate für Websites von Maven Projekte zu schreiben? Ist ein ausdrucksvoller als das andere? Hat ein besseres Werkzeug Unterstützung als die andere hat?

Answer 1

Das XDOC Format ist definitiv ein reicher Mechanismus für die Erstellung von Dokumenten und ist erforderlich, wenn Sie mit TOC / TOF, Header produzieren Dokumente wollen, Fußzeilen oder Fußnoten (und anderen Dokumentattributen), da das APT-Format diese nicht unterstützt.

aber sagen, dass ich dazu neigen, die APT-Format für fast alle internen Dokumente zu verwenden, wie ich in der APT-Format genießen zu schreiben. Im Vergleich zu XDOC Schreiben (mit all seinem XML Lieblichkeit), ist APT ein Kinderspiel. Aus dem gleichen Grunde, wenn ich ein Plugin zu schreiben, die Inhalte erzeugt, neige ich dazu, das XDOC Format zu verwenden, da es ziemlich einfach ist, Software zu schreiben, die die erforderliche XML erstellt.

Answer 2

APT-Format ist einfach zu bedienen. Allerdings ist es nicht individuelle Styling (zum Beispiel ein Zeichen oder eine Überschrift Styling) unterstützen. In der Nähe von vorformatiert Text, den Sie mit APT verwenden können, ist der „wörtlich Text“ Wie in HTML, ist wörtlich Text vorformatiert. Im Gegensatz zu HTML ist wörtlich Text entronnen in einem wörtlich Display, Markup vom APT-Prozessor nicht interpretiert wird,

.