Doxygen: наличие «модулей» в таблице содержания с кодом Fortran дважды

Question

В настоящее время я документирую проект программного обеспечения F95 / 2003 с помощью doxygen. С одной стороны, я сгруппировал соответствующие страницы с помощью @defgroup, @addtogroup, @ingroup .... которые заканчиваются точкой Модули в оглавлении и верхнем меню. Затем проект также содержит модули Fortran, должным образом документированные, и они также представлены в виде отдельной Модули в таблице содержания, что затрудняет их различение guish. Как я могу переименовать один из них? Подобно именованию страниц модулей, сгенерированных из документации модулей Fortran, как Модули Fortran , или лучшим вариантом будет полное избавление от отдельных страниц модулей для модулей Fortran, поскольку они также принадлежат группе doxygen и там можно найти как хорошо?

Answer 1

В принципе «Модули Fortran» перечислены как пространства имен, но с помощью OPTIMIZE_FOR_FORTRAN = YES имя меняется на «Модули». Конечно, трудно получить правильное наименование.

Doxygen также имеет возможность изменить, в отношении имен и отображения / скрытия) некоторые элементы макета, см. Параграф руководства по doxygen: «Изменение макета pages "(http://doxygen.nl/manual/customize.html#layout).

при создании файла макета скажите:

doxygen -l mylayout.xml

и измените здесь строку (приблизительно строка 8):

<tab type="namespaces" visible="yes" title="">

в

<tab type="namespaces" visible="yes" title="Fortran Modules">

и настройку в файле конфигурации doxygen (Doxyfile):

LAYOUT_FILE            = mylayout.xml

Я думаю, вы получите желаемый эффект.

Следующее я не пробовал (поэтому я не знаю, каков может быть эффект в вашем случае, и у меня большие сомнения, но я упомянул это здесь для полноты, как это пришло мне в голову), но doxygen также команда \namespace может быть, вы можете использовать это в этом случае вместо команд группировки.