From 57f05246863d19cb1bbc5e052577aaa7d5dfcc2e Mon Sep 17 00:00:00 2001 From: Elena ``of Valhalla'' Grandi Date: Tue, 26 Jul 2011 07:56:43 +0200 Subject: Struttura --- esempi/03.rst | 89 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 esempi/03.rst (limited to 'esempi') diff --git a/esempi/03.rst b/esempi/03.rst new file mode 100644 index 0000000..c202653 --- /dev/null +++ b/esempi/03.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. + -- cgit v1.2.3