How to make an internal hyperlink in sphinx documentation

Question

How to make an internal hyperlink in sphinx documentation? I use:

:role:`target` 

But it does not work.

Answer 1

Cross reference done with ref

 :ref:`label-name` 

You can specify your tags using:

 .. _label-name: 

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

Roles are used to create custom interpretable text. See: http://docutils.sourceforge.net/docs/ref/rst/directives.html#role