diff options
| -rw-r--r-- | esempi/05.rst | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/esempi/05.rst b/esempi/05.rst index ec719e4..52f2c4e 100644 --- a/esempi/05.rst +++ b/esempi/05.rst @@ -5,8 +5,54 @@ 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>`_ + |