In section "Cross-referencing arbitrary locations", the document says that you can create a reference: .. _my-reference-label: Some text here. Then link to the reference like this: Refer to :ref:`my-reference-label`.


The :ref: role has two different forms.  The one you are using,
:ref:`my-reference-label`, only works if the label comes immediately
before a section title like this:

.. _my-reference-label: Section to cross-reference -------------------------- This is the text of the section.


If the label does not come before a section title, like the one in your example, you have to use the alternate :ref: form, like this:

   :ref:`Text to display <my-reference-label>`


--
Jonathan Waltman

--
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to