1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
===========
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>`_
|
