Doxygen:在 Content with Fortran Code 的 Table 中有两次 "Modules"

Doxygen: Having "Modules" twice in the Table of Content with Fortran Code

我目前正在 doxygen 的帮助下记录一个 F95/2003 软件项目。一方面,我在 @defgroup@addtogroup@ingroup 的帮助下对相应的页面进行了分组,最终在点 Modules 下在 table 目录和顶部菜单中。然后该项目还包含 Fortran 模块,已正确记录,它们也作为单独的 Modules 点出现在 table 的内容中,这使得它们很难区分。我怎样才能重命名其中之一?就像将 Fortran 模块文档生成的模块页面命名为 Fortran 模块 或者最好的选择是完全摆脱 Fortran 模块的单独模块页面,因为它们也属于一个 doxygen 组,也可以在那里找到吗?

原则上 "Fortran modules" 被列为名称空间,但是通过 OPTIMIZE_FOR_FORTRAN = YES 名称被更改为 "Modules"。要得到正确的命名当然是个难题

Doxygen 也有可能更改,关于名称和显示/隐藏)一些布局元素,请参阅 doxygen 手册段落:"Changing the layout of 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 命令也许你可以在这种情况下使用它来代替分组命令。