aboutsummaryrefslogtreecommitdiff
path: root/esempi/05.rst
diff options
context:
space:
mode:
authorElena ``of Valhalla'' Grandi <elena.valhalla@gmail.com>2012-03-24 17:21:22 +0100
committerElena ``of Valhalla'' Grandi <elena.valhalla@gmail.com>2012-03-24 17:21:22 +0100
commit45574a5b4a5e78b0fac0987ecc259344ee54245e (patch)
tree99570b336d32e69291921670777ad0176a4aef6c /esempi/05.rst
parent18cbe8f8092f1bd1a035c3f3ea1cb26dcd981ff8 (diff)
Riferimenti
Diffstat (limited to 'esempi/05.rst')
-rw-r--r--esempi/05.rst46
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>`_
+