“重复的隐式目标名称”：如何多次使用字幕名称？

Question

如何在 sphinx/rst 的多个部分中使用相同的小节标题？

我不认为这是一个奇怪的用例。我只想为每个部分迭代相同的小节标题。

############
TITLE OF ALL
############

-------
CHAPTER
-------

SENARIO ONE
===========

Description
-----------

SENARIO TWO
===========

Description
-----------

生成此错误：

design_spec.rst:19: (INFO/1) Duplicate implicit target name: "description"

当然，我不会在整个文档中提出独特的小节标题。我错过了什么？

它抱怨标题生成的隐式目标名称不是唯一的。我该怎么办？

Answer 1

如果您为第二（和第三...）部分“描述”定义显式目标名称，则可以避免该信息，如下所示：

...

Description
-----------

SENARIO TWO
===========

.. _description2:

Description
-----------

...

如果您想跳转到那里（例如mypage#description2 ） ，这还为您提供了拥有已知锚点的好处。

不要错过 _description 和以下部分标题之间的空行。