Sphinx中的reStructuredText：引用节时显示数字

Question

要在Sphinx中使用reStructuredText引用一个部分，我可以这样做：

.. _my-reference-label:

Section to cross-reference
--------------------------

This is the text of the section.

It refers to the section itself, see :ref:`my-reference-label`.

解释here。

这导致该部分被标题引用，即我得到了这一行：

  

它指的是该部分本身，请参阅 Section to cross-reference 。

（其中交叉引用的部分链接到相应部分的开头）

我想改为：

  

它指的是该部分本身，请参阅 2.1 。

其中 2.1 是部分的编号。

有没有办法在Sphinx中使用reStructuredText来实现这一目标？

Answer 1

numsec Sphinx扩展可以满足您的需求。源代码位于：https://github.com/jterrace/sphinxtr/blob/master/extensions/numsec.py。

该扩展是Stack Overflow成员jterrace开发的“Sphinx论文资源”包的一部分。请参阅https://github.com/jterrace/sphinxtr。