Создание однофайловой документации по HTML-коду

Как я могу использовать Doxygen для создания документации HTML как одного очень длинного файла? Я хочу что-то вроде RTF-вывода, но как HTML.

Причина: мне нужен мой API, опубликованный как единый документ для печати. Что-то, что можно загрузить в Word, преобразовать в PDF и т.д.

Ответ 1

Я думаю, что вы можете использовать HTMLDOC для преобразования сгенерированных файлов HTML в один файл HTML. (Сам не пробовал)

Руководство включает в себя следующий пример для создания HTML из двух исходных файлов HTML:

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

Но есть и графический интерфейс.

Ответ 2

Я не думаю, что есть опция, которая будет выводить результат как один HTML файл, но выход RTF может быть подходящим, если вам нужен редактируемый формат вывода (я не пробовал это сам, поэтому не знаю как хорошо это работает).

Если вы хотите получить качественный вывод для печати, тогда Doxygen может выводить формат LaTeX (установите GENERATE_LATEX в YES в конфигурационный файл doxygen). Затем это можно преобразовать в PDF, хотя вам необходимо установить дистрибутив LaTeX, например MiKTeX.

Ответ 3

Я также ищу возможность создать один большой вывод HTML из Doxygen, где мы используем уценки с \subpage

SubPage предоставляет нам управляемые части документа, которые хорошо поделены для совместной работы. Один выходной файл HTML помогает при печати HTML или загрузке HTML в PDF или Word.

Ссылки полезны в реальном документе, но для печати ссылки не являются удобными для пользователя