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

2023年1月21日 242次阅读

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

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

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

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

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

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

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

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

生成此错误：

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

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

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

最佳答案 如果为第二个(和第三个……)部分“描述”定义显式目标名称,则可以避免该信息,如下所示：

...

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

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

.. _description2:

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

...

如果你想跳到那里(例如mypage#description2),这还可以让你拥有一个已知的锚点.

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

点赞