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)?
documentation
templates
documentation-generation
Cole Johnson
źródło
źródło
Odpowiedzi:
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.
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ć.
źródło