使Sphinx自动生成单页文档并链接到每个生成页面的顶部

Question

我已经使用Sphinx自动生成记录一系列功能的单独页面。摘要页面如下所示：

.. autosummary::
   :toctree: functions

   first_function

   second_function

   third_function

然后每个函数都会在functions/文件夹中获得自己的文件，如下所示：

first_function
==============

.. currentmodule:: my_module

.. autofunction:: first_function

哪个很棒，（几乎）正是我想要的。唯一的问题是，在摘要页面上生成的TOC链接链接到所生成页面而不是页面顶部的子标题。这看起来很难看，并且让我发疯。

具体来说，当我生成html并单击“ first_function”时，它将发送给我：

functions/my_module.first_function.html#my_module.first_function

但是，像任何理智的理性人一样，我希望它可以将我发送给这个人

functions/my_module.first_function.html