Добавить XML-файл в список файлов

Я хочу добавить содержимое файла XML в документацию, сгенерированную doxygen. Я добавил файл XML в тег INPUT файла конфигурации doxygen. Однако, хотя XML-файл указан в списке файлов, содержимое файла не отображается. Что мне нужно сделать, чтобы включить содержимое?


person Tobi Weißhaar    schedule 24.01.2012    source источник


Ответы (1)


Doxygen не имеет встроенной поддержки разбора XML, поэтому вы не можете использовать INPUT, но можете включить в вывод содержимое XML-файла.

Предположим, ваш XML-файл называется test.xml и находится в каталоге xml (относительно того, где запускается doxygen). Затем вы можете использовать следующий блок комментариев:

/** @page xml_example My XML File
 *  Here is my xml file included in the doxygen output:
 *  @verbinclude test.xml
 */

чтобы убедиться, что doxygen может найти файл XML, вам нужно указать путь к каталогу xml

EXAMPLE_PATH = xml
person doxygen    schedule 24.01.2012
comment
Спасибо ;) Вы не знаете, можно ли также создать новую пользовательскую вкладку, например, примеры или связанные страницы? - person Tobi Weißhaar; 25.01.2012
comment
Если вы получили последний снимок из SVN, вы можете создать собственный файл макета (с параметром -l), и туда вы можете добавить пользовательские вкладки. Создайте документацию из SVN, запустив make в каталоге документации, чтобы узнать, как определить такие пользовательские вкладки. - person doxygen; 25.01.2012