Expert Python Programming - Third Edition

Links

A text can be changed into an external link with a special line starting with two dots, as long as it is provided in the document:

Try `Plone CMS`_, it is great ! It is based on Zope_. 
 
.. _`Plone CMS`: http://plone.org 
.. _Zope: http://zope.org 

The usual practice is to group the external links at the end of the document. When the text to be linked contains spaces, it has to be surrounded with ` (backtick) characters.

Internal links can also be used by adding a marker to the text:

This is a code example 
 
.. _example: 
 
:: 
 
    >>> 1 + 1 
    2 
 
Let's continue our text, or maybe go back to 
the example_.

Sections are also targets that can be used:

============== Document title ============== Introduction to the document content. Section 1 ========= ...