diff options
Diffstat (limited to 'esempi/03.rst')
| -rw-r--r-- | esempi/03.rst | 89 |
1 files changed, 0 insertions, 89 deletions
diff --git a/esempi/03.rst b/esempi/03.rst deleted file mode 100644 index c202653..0000000 --- a/esempi/03.rst +++ /dev/null @@ -1,89 +0,0 @@ -=========== - Struttura -=========== - ------------------- - Una rapida guida ------------------- - -Titoli e sezioni -================ - -Testo decorato --------------- - -reStructuredText indica i titoli con il cosiddetto -“testo decorato”: una riga di testo sottolineata ed -eventualmente sopralineata con un carattere a scelta tra -``= - ` : ' " ~ ^ _ * + # < >``. -Righe decorate con caratteri differenti sono considerati -livelli di titolo diverso, ed una sopra-e-sottolineatura -è considerata diversa da una semplice sottolineatura -con lo stesso carattere. - -Una riga sopra-e-sottolineata può iniziare con uno o -più spazi, per estetica, contrariamente ad una -riga solo sottolineata. - -Titolo e sottotitolo --------------------- - -Un livello unico all'inizio del documento viene interpretato -come titolo dello stesso, e un'eventuale secondo livello -unico subito successivo è considerato il sottotitolo. - -Sezioni, capitoli, parti ------------------------- - -Ulteriori livelli servono per dare al documento una struttura: -non c'è una corrispondenza tra carattere usato e tipo -di livello (capitolo, sezione, sottosezione, ecc.); -reST riconosce la gerarchia in modo “numerico” -(primo livello, secondo livello, ecc.) e sarà poi -l'applicazione a dare un significato più preciso, -ad esempio riconoscendo che un articolo è diviso -in sezioni, mentre un libro avrà dei capitoli. - -Transizione ------------ - -Un'ulteriore elemento di struttura è quello che indica -le transizioni; indicate generalmente nei testi stampati -con una o più righe vuote, e in html con una riga -orizzontale, in reST si indicano con 4 o più caratteri -ripetuti scelti tra quelli usabili per i titoli. - ------- - -Una transizione non può essere all'inizio o alla fine -di una sezione, e non si possono usare più sezioni -consecutive, non separate da testo. - -Livelli ulteriori -================= - -Sottosottosezione -~~~~~~~~~~~~~~~~~ - -Avendo usato un carattere diverso, quest'ultimo titolo non -indica lo stesso livello delle sottosezioni della sezione -precedente, ma un livello più basso. - -Scelta dei caratteri --------------------- - -reST non fa alcuna distinzione tra i caratteri usati per -decorare una riga, purché siano distinti, e permette -ad esempio di usare una sopra-e-sottolineatura -per indicare un sotto-sotto-sotto-sotto-paragrafo. -Dato che però reST è nato per essere leggibile in formato -sorgente, può essere opportuno attenersi alle usanze -della maggior parte dei suoi utenti che sono soliti -usare ``=`` e ``-`` per i primi due livelli, e -dare alle sopra-e-sottolineature un livello gerarchico -superiore a quello delle sottolineature, spesso -riservandole a titolo e sottotitolo del documento. - -Ulteriori caratteri non hanno un significato universale, -anche se potrebbero esistere delle convenzioni locali. - |