Блог

Я бы хотел, чтобы номер версии моего проекта отображался в выводе Doxygen XML, чтобы я мог программно получить его. Я настроил PROJECT_NUMBER, и значение, которое я там использовал, отображается в выводе HTML для той же сборки, но не для вывода XML. Я проверил папку вывода XML для необработанного текста значения, которое я ввел в PROJECT_NUMBER, и оно нигде не появляется. Просматривая параметры конфигурации Doxygen, я не смог найти ничего, что могло бы управлять этим, кроме самого PROJECT_NUMBER, поэтому я не думаю, что это только проблема конфигурации.

Это просто не функция для Doxygen? Если да, то есть ли обходной путь для получения этого значения в выводе XML? Номер версии генерируется в процессе сборки документации, и я бы настоятельно предпочел не сохранять его непосредственно в каком-либо исходном файле.

Я использую Doxygen 1.8.11

Окончательного ответа нет, но это решение, которое я буду использовать, если больше ничего не появится.

Создайте псевдоним:

 ALIASES = "myversion=anchor version xmlonly a.b.c endxmlonly"
 

Где ‘a.b.c’ — это номер версии, который также был помещен в PROJECT_NUMBER .

Затем поместите myversion тег в блок комментариев, помеченный как page или mainpage , поскольку anchor он должен быть в одном из них (исходном).

Это не идеально, но затем вы можете использовать привязку, чтобы легко найти версию в xml. В моем случае вывод xml был:

 <para><anchor id="index_1version"/> a.b.c </para>
 

в подробном описании страницы, так что вы можете просто получить текстовое содержимое прилагаемого тега ‘para’.

Мне не обязательно нужен xmlonly тег, но поскольку PROJECT_NUMBER уже отображается в html, случайное распечатывание номера версии в другом месте не требуется.