Comment créer un lien hypertexte interne dans la documentation sphinx

Question

Comment créer un lien hypertexte interne dans la documentation sphinx? J'utilise:

:role:`target` 

Mais il ne fonctionne pas.

Answer 1

références croisées est effectuée à l'aide d'un ref

:ref:`label-name` 

Vous pouvez fournir vos étiquettes en utilisant:

.. _label-name: 

Voir: http://sphinx.pocoo.org/markup/inline.html#ref-role

Les rôles sont utilisés pour créer un texte interprété personnalisé. Voir: http://docutils.sourceforge.net/docs/ref/rst/directives.html#role