"Duplicate implicit target name" : comment utiliser un nom de sous-titre plus d'une fois ?

Question

Comment utiliser le même titre de sous-section dans plusieurs sections de sphinx/rst ?

Je ne pensais pas qu'il s'agissait d'un cas d'utilisation étrange. Je veux juste itérer à travers les mêmes titres de sous-sections pour chaque section.

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

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

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

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

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

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

génère cette erreur :

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

Je ne suis certainement pas censé trouver des titres de sous-sections uniques pour l'ensemble du document. Qu'est-ce qui m'a échappé ?

Il se plaint de la implicite le nom de la cible généré par les titres n'est pas unique. Que puis-je faire à ce sujet ?

Answer 1

Vous pouvez éviter l'info si vous définissez un nom cible explicite pour la deuxième (et troisième ...) section "Description" comme ceci :

...

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

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

.. _description2:

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

...

Cela vous permet en outre de disposer d'un point d'ancrage connu si vous souhaitez sauter à cet endroit (comme mapage#description2 ).

Ne manquez pas la ligne blanche entre _description et le titre de la section suivante.