From 40fa461d8ec2b7835e50b41f639e3444694ba0ea Mon Sep 17 00:00:00 2001 From: Elena ``of Valhalla'' Grandi Date: Tue, 26 Jul 2011 08:15:02 +0200 Subject: Struttura: spostato come secondo esempio --- esempi/02.rst | 89 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ esempi/03.rst | 89 ----------------------------------------------------------- 2 files changed, 89 insertions(+), 89 deletions(-) create mode 100644 esempi/02.rst delete mode 100644 esempi/03.rst diff --git a/esempi/02.rst b/esempi/02.rst new file mode 100644 index 0000000..fb59d18 --- /dev/null +++ b/esempi/02.rst @@ -0,0 +1,89 @@ +=========== + 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. + 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. - -- cgit v1.2.3