Czy doxygen obsługuje szablony danych wyjściowych HTML?

10

Udokumentowałem swój kod doxygen, ale nie chcę domyślnego kodu HTML, który daje. Wiem, że mogę go dostosować, udostępniając niestandardowe pliki CSS, nagłówki, stopki itp. (Podobnie jak GNOME), a także sposób dodawania do plików wspólnego kodu PHP i polecenia zapisania go jako .php, ale tak naprawdę nie tego chcę .

To, czego chcę, to dane wyjściowe takie jak MSDN. Naprawdę nie potrafię tego opisać. Moje pytanie brzmi: czy jest to możliwe przy użyciu doxygen z czymś takim jak szablony, czy też muszę wyprowadzać XML i parsować go za pomocą innego programu (którego nie miałbym nic przeciwko pisaniu)?

Cole Johnson
źródło
Może przyjrzeć się temu: integracja MSDN Dla tych, którzy korzystają z systemu Windows i chcą zintegrować skompresowany kod HTML wygenerowany przez doxygen z MSDN, spójrz na to narzędzie integrujące MSDN. stack.nl/~dimitri/doxygen/helpers.html

Odpowiedzi:

7

O ile wiem, Doxygen nie obsługuje gotowych szablonów HTML . Możesz odnieść się do obrazu poniżej (z oficjalnej strony domowej doxygen ). Pokazuje pliki wejściowe i wyjściowe powiązane z całym procesem tworzenia dokumentacji.

wprowadź opis zdjęcia tutaj

Jak widać, doxygen odczytuje tak zwany „plik układu”. Ten plik można dostosować ! Jakkolwiek jesteś ograniczony do struktury strony, doxygen tworzy.

Jeśli potrzebujesz większej elastyczności, wolisz transformację danych XML w formacie XSLT . Istnieje również próbka pokazująca, jak to zrobić.

Aschratt
źródło