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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
=============
Formattazione
=============
Formattazione inline
====================
reStructuredText formalizza alcune convenzioni
tradizionali per indicare quando un testo deve essere
*enfatizzato* o, in caso di necessità **estremamente
enfatizzato**, racchiudendolo tra asterischi adiacenti
al testo da enfatizzare.
In generale reST riesce a capire quando un asterisco
non è parte dell'enfasi, ad esempio scrivendo 2*2,
ma se necessario è possibile inserire un asterisco
preceduto da un *backslash* anche all'inizio o alla
fine di una parol\*.
Un'ulteriore convenzione viene usata per racchiudere
testo da mantenere inalterato, usata ad esempio per
nomi di programma come ``adventure(6)``, comandi
``rm -rf /``, brevi spezzoni di codice ``print "Hello
World!"``.
Tale testo può includere caratteri significativi per
reStructuredText, che non verranno interpretati; ad
esempio ``*questo testo non è enfatizzato*``.
Formattazione dei blocchi
=========================
Si può indicare che un paragrafo non è normale testo,
ma ha un significato particolare che richiede
diverso trattamento.
Blocco letterale
----------------
Un testo che deve mantenere la formattazione, riportando
letteralmente tutti i caratteri in esso contenuti,
compresi spazi e ritorni a capo, si indica così::
def greet():
print "Hello World!"
Ovvero con un paragrafo indentato preceduto da una
coppia di due punti alla fine del paragrafo precedente.
I due punti possono anche costituire da soli un paragrafo.
::
anche questo è un blocco letterale
e può contenere persino dei *caratteri significativi*
per reST, che non vengono interpretati.
Paragrafi con ritorni a capo
----------------------------
| Se le righe di un paragrafo
| iniziano con una barra verticale
| anche detta *pipe*
| la formattazione viene interpretata
| ma i ritorni a capo vengono conservati
| e persino l'indentazione.
| Questo è utile per scrivere poesie.
| Se però si vuole una riga più lunga
basta iniziarla con uno spazio, al posto
della barra verticale.
Markup esplicito e commenti
---------------------------
Una riga che inizia con due punti ed uno spazio::
.. <comando>
indica l'inizio di un blocco di markup esplicito, il cui significato
dipende ovviamente dal comando usato.
Usato con testo generico che non sia un comando reStructuredText,
viene considerato un commento.
.. Questo testo non verrà mostrato.
Ma ad esempio potrebbe essere trasformato in un commento in HTML.
|
