"复制隐含目标名称":如何多次使用字幕名称?

时间:2016-09-27 06:30:30

标签: python-sphinx restructuredtext

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

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

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

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

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

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

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

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

生成此错误:

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

当然,我并不期望在整个文件中提出独特的分段标题。我错过了什么?

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

1 个答案:

答案 0 :(得分:2)

如果为第二个(和第三个......)部分定义明确的目标名称,则可以避免该信息"描述"像这样:

...

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

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

.. _description2:

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

...

如果你想跳到那里(例如 mypage#description2 ),你还可以获得已知锚点的好处。

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