使用 doxygen 生成 Python 文档会产生断开的函数链接

Question

Doxygen 版本：1.8.12 --默认配置

我一直在使用 Doxygen 生成我的 Python 文档。它在记录类时运行良好。然而，我现在已经构建了几个具有一些功能的模块，我正在记录如下：

 ## @file
 #  my module comment

 ##
 # my function
 # @return 0
 def func():
     return 0

然后它会创建一个标签Files，我可以在其中找到我的模块文件。但是，当我单击它们时，功能列表会显示为链接，这些链接已损坏（单击页面时会重定向到自身），并且模块的实际定义会附加在页面末尾。

我应该怎么做才能避免链接断开，也许与类（函数具有单独的 html）发生的类似行为更可取

====更新==== 在检查生成的 html 代码时，显然链接指向这种风格的地址：

Documtenation/myfilepy.html#some_hash

而实际的页面部分具有这种样式的 id：

 file_some_hash

调用链接的正确方法应该是：

Documentation/myfilepy#file_some_hash

如何让 doxygen 删除 file_ 或正确生成链接？

Answer 1

我刚刚尝试使用 1.8.12（以及 1.8.14 当前和首选版本以及当前开发版本）。我在Files 页面上看到了指向myfile.py 的链接（因为我从\file 命令中删除了myfile 这个词）。在 myfile.py 页面上，我看到了 1 个指向 myfile.func 的链接，但引用无处可去。

尝试使用 C 函数进行相同操作时，它确实有效。 查看我在Functions 部分看到的 HTML 代码（对于 C）：

<a class="el" href="bb_8c.html#a916cba588658b3be41b91489a560a664">c_func</a>

和

<a href="#a916cba588658b3be41b91489a560a664">More...</a>

在Function Documentation 部分更下方：

<a id="a916cba588658b3be41b91489a560a664"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a916cba588658b3be41b91489a560a664">&#9670;&nbsp;</a></span>c_func()</h2>

查看我在Functions 部分看到的 HTML 代码（对于 Python）：

<a class="el" href="myfile_8py.html#a3f1962c8fd3ce4b252b1015bf4cb3c32">myfile.func</a>

和

<a href="myfile_8py.html#a3f1962c8fd3ce4b252b1015bf4cb3c32">More...</a>

在Function Documentation 部分更下方：

<a id="file_a3f1962c8fd3ce4b252b1015bf4cb3c32"></a>
<h2 class="memtitle"><span class="permalink"><a href="#file_a3f1962c8fd3ce4b252b1015bf4cb3c32">&#9670;&nbsp;</a></span>func()</h2>

显然，Python 版本中的 file_ 不应该存在（file_ 与文件名无关，因为像 something.py 这样的文件名给出了相同的结果）。

注意：我在代码中找到了memberdef.cpp：

// member is in a namespace, but is written as part of the file documentation
// as well, so we need to make sure its label is unique.

编辑：根据我已经在 cmets 中提出的建议，我刚刚将其作为提议的补丁推送到 github（拉取请求 720，https://github.com/doxygen/doxygen/pull/720）。