Unterstützt doxygen Vorlagen für die HTML-Ausgabe?

Ich habe meinen Code für dokumentiert doxygen, möchte aber nicht den Standard-HTML- Code , den er enthält. Ich weiß, dass ich es anpassen kann, indem ich benutzerdefiniertes CSS, Kopf- und Fußzeilen usw. bereitstelle (wie es GNOME tut) und wie ich den Dateien allgemeinen PHP-Code hinzufügen und ihn zum Speichern anweisen kann .php, aber das ist nicht wirklich das, was ich will .

Was ich will, ist die Ausgabe wie MSDN. Ich kann es nicht wirklich beschreiben. Meine Frage ist: Ist dies mit doxygen mit so etwas wie Vorlagen möglich, oder muss ich XML ausgeben und es mit einem anderen Programm analysieren (das ich gerne schreiben würde)?

documentation templates documentation-generation Cole Johnson
quelle

Könnte dies untersuchen: MSDN-Integration Wenn Sie Windows verwenden und den von doxygen generierten komprimierten HTML-Code in MSDN integrieren möchten, sehen Sie sich dieses MSDN-Integrator-Dienstprogramm an. stack.nl/~dimitri/doxygen/helpers.html

Antworten:

Soweit ich weiß, unterstützt Doxygen keine sofort einsatzbereiten HTML-Vorlagen . Sie können sich auf das Bild unten beziehen (von der offiziellen Doxygen-Homepage ). Es zeigt die Eingabe- und Ausgabedateien, die sich auf den gesamten Workflow für die Dokumentationserstellung beziehen.

Geben Sie hier die Bildbeschreibung ein

Wie Sie sehen können, liest doxygen eine sogenannte "Layoutdatei". Diese Datei kann angepasst werden ! Sie sind jedoch irgendwie auf die Seitenstruktur beschränkt, die doxygen erstellt.

Wenn Sie mehr Flexibilität benötigen, sollten Sie die XSLT-Transformation der XML-Ausgabe bevorzugen . Es gibt auch ein Beispiel , das Ihnen zeigt, wie das geht.

Aschratt
quelle