python-sphinx - 狮身人面像 : Write footnotes in place, 显示在最后

Question

我希望能够在引用脚注的地方创作脚注，但只在文档末尾显示，其中 .. rubric: Footnotes出现。

像这样:

Lorem Ipsum[#lorem]_ dolor sit blah blah.

.. [#lorem]

   The footnote text here.

The next paragraph. Salve regina mater misericordiae, vita dulcedo.

.. rubric: Footnotes

期望的输出:

Lorem Ipsum^1 dolor 坐等等等等。

下一段。药膏 regina mater misericordiae, vita dulcedo。

脚注:
1 这里的脚注文本。

根据 the docutils docs这应该是可能的:

Footnotes may occur anywhere in the document, not only at the end. Where and how they appear in the processed output depends on the processing system.

但是我找不到如何让处理系统(Sphinx，使用内置的 make html )只将它们放在底部，而不是它们出现的任何地方。

Answer 1

我使用了脚注方法，但是，您必须小心放置引用的位置。所以，我的 modules.rst看起来像这样:

Brief
-----

.. automodule:: modules
   :members:
   :undoc-members:
   :show-inheritance:


Sub modules
-----------

.. toctree::
   :maxdepth: 4

   modules.ahp
   modules.grid

Plot module
-------------------

.. automodule:: modules.Plot
   :members:
   :undoc-members:
   :show-inheritance:

Score module
-------------------

.. automodule:: modules.Score
   :members:
   :undoc-members:
   :show-inheritance:

Skillset module
-------------------

.. automodule:: modules.Skillset
   :members:
   :undoc-members:
   :show-inheritance:

util module
-------------------

.. automodule:: modules.util
   :members:
   :undoc-members:
   :show-inheritance:

|hr|

.. rubric:: Footnotes

.. [#euclidian] `Wikipedia <https://en.wikipedia.org/wiki/Dot_product#Geometric_definition>`_

从那以后我的 utils模块包含我使用脚注的功能，它的工作原理与预期相同。 (它只是在当前页面中创建对 div 的引用)