Generowanie dokumentacji pojedynczego pliku kodu HTML

Question

Jak używać Doxygen do tworzenia dokumentacji HTML jako pojedynczego, bardzo długiego pliku? Chcę coś takiego jak wyjście RTF, ale jako HTML.

Powód: potrzebuję mojego interfejsu API opublikowanego jako pojedynczy, możliwy do wydrukowania dokument. Coś, co można załadować do Worda, przekonwertować na PDF, itp.

Answer 1

Myślę, że można użyć HTMLDOC do konwersji wygenerowanych plików html do jednego pliku html. (I nie próbował go samodzielnie)

manual zawiera następujący przykład do generowania html z plików HTML dwa źródła:

htmldoc --book -f output.html file1.html file2.html 

Ale istnieje także gui.

Answer 2

Nie sądzę, że istnieje opcja, która wytworzy wynik jako pojedynczy plik HTML, ale wyjście RTF może być odpowiednie, jeśli potrzebujesz edytowalnego wyjścia format (sam tego nie próbowałem, więc nie wiem, jak to działa).

Jeśli chcesz mieć dobrą jakość wydruków, Doxygen może wyprowadzać format LaTeX (ustaw GENERATE_LATEX na YES w swoim pliku konfiguracyjnym doxygen). Można to następnie przekonwertować na format PDF, chociaż musisz zainstalować dystrybucję LaTeX, taką jak MiKTeX.