Doxygen: групповые модули и страницы?

У меня вопрос о страницах и группах в doxygen. У меня есть проект, в котором я группировал классы и т.д. С помощью команд @defgroup и @grouproup. Пока это прекрасно работает.

Теперь я хотел бы добавить специальную документацию к проекту со страницами разметки. Эти страницы должны отображаться в выделенном модуле (группе). Я попытался создать страницы с помощью @page и @subpage. Это работает нормально, но в меню отображаются простые строки.

Итак, я попытался добавить их в группы с @grouproup. Но это не работает, как я догадывался. Можно ли добавлять страницы в модули (группы)?

Результат должен выглядеть так:


Project  | - Общение  | | - Общение  | | | - Документация страницы1 (из файла *.md)
 | | | - Общение  | | - Общение  | | | - Общение  | | | - Документация по классу

Надеюсь, ты поможешь мне!

Ответ 1

Чтобы сгруппировать страницы, вам нужно использовать функциональные возможности подстраницы, а не группу.

Итак, создайте страницу для каждой группы, которая ссылается как на подстраницы, так и на группу модулей.

/*! \page group1page A documentation page for my group
This page contains the info about group 1 \ref group1_label
\subpage group1page2
\subpage group1page3
*/

http://www.stack.nl/~dimitri/doxygen/manual/grouping.html#subpaging http://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdsubpage