===========
Riferimenti
===========

Link
====

Per inserire un link, ad esempio a reStructuredText_, si può usare un 
`riferimento nel testo`_, che può essere una parola o una frase 
racchiusa tra apici rovesciati seguiti dal carattere "_"; altrove 
nel documento si specificherà la destinazione del link in una riga 
composta da due punti, spazio, "_", il riferimento usato 
prima, un carattere ":" e la destinazione del link.

.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _`riferimento nel testo`: reStructuredText_

La destinazione di un link può essere un'URL come nell'esempio sopra, 
ma anche una posizione all'interno del documento, ad esempio ad 
un titolo di sezione come link_, oppure ad una destinazione_ 
definita esplicitamente come nel caso precedente, ma senza specificare 
un'URL.

.. _destinazione:

L'inizio di questo paragrafo può essere raggiunto con il nome 
``destinazione_``.

Un altro modo per inserire link è specificare la destinazione immediatamente 
dopo l'etichetta, ad esempio come in questo riferimento al 
`ReStructuredText Primer <http://docutils.sourceforge.net/docs/user/rst/quickstart.html>`_.
Generalmente risultano meno leggibili, anche se possono essere 
pratici in alcuni casi come gli elenchi di link.

Note a pié di pagina
====================

Anche le note a pié di pagina vengono inserite con un riferimento 
nel testo [1]_ seguito dalla loro definizione [#defin]_. 

.. [1] Composto da un carattere [#carattere]_ compreso tra parentesi quadre 
   e seguito da un ``\_``.
.. [#defin] Composta dalla solita sequenza di due punti ed uno spazio, 
   lo stesso riferimento e il testo della nota.
.. [#carattere] che può essere un numero, ``#`` per chiedere di numerare 
   in automatico le note, ``#`` seguito da un nome per numerare 
   in automatico dando un'etichetta alle note, in modo da evitare ambiguità, 
   oppure infine ``*`` per generare in automatico un simbolo.

Citazioni
=========

Le citazioni di fonti si inseriscono in modo simile alle note a piè di 
pagina, usando però un etichetta che può contenere caratteri alfanumerici, 
underscore, trattini e punti. [RST2009]_

.. [RST2009] `Quick reStructuredText <http://docutils.sourceforge.net/docs/user/rst/quickref.html>`_