diff options
Diffstat (limited to 'esempi')
| -rw-r--r-- | esempi/03.rst | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/esempi/03.rst b/esempi/03.rst new file mode 100644 index 0000000..ccc602e --- /dev/null +++ b/esempi/03.rst @@ -0,0 +1,70 @@ +============= +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. + + |