Я задокументировал свой код для doxygen
, но я не хочу использовать HTML по умолчанию. Я знаю, что могу настроить его, предоставляя собственные CSS, верхние и нижние колонтитулы и т. Д. (Как это делает GNOME), и как я могу добавить общий PHP-код в файлы и сказать, чтобы он сохранялся как .php
, но это не совсем то, что я хочу ,
То, что я хочу, это вывод, как MSDN. Я не могу описать это действительно. У меня вопрос: возможно ли это с помощью doxygen с чем-то вроде шаблонов, или мне нужно вывести XML и проанализировать его с другой программой (которую я не прочь написать)?
documentation
templates
documentation-generation
Коул Джонсон
источник
источник
Ответы:
Насколько мне известно, Doxygen не поддерживает что-то вроде HTML-шаблонов из коробки. Вы можете обратиться к изображению ниже (с официальной домашней страницы Doxygen ). Он показывает входные и выходные файлы, связанные со всем процессом создания документации.
Как видите, doxygen читает так называемый «файл макета». Этот файл можно настроить ! Однако вы как-то ограничены структурой страницы, создает doxygen.
Если вам нужна большая гибкость, вы должны предпочесть XSLT-преобразование вывода XML . Существует также пример, который показывает вам, как это сделать.
источник