From cd2ddf9287c3acfd941ac30d89d0c38cbc9a9a85 Mon Sep 17 00:00:00 2001 From: Elena ``of Valhalla'' Grandi Date: Mon, 26 Mar 2012 09:50:28 +0200 Subject: Estensioni di reST --- esempi/06.rst | 141 ++++++++++++++++++++++++++++++++++++++-------------------- esempi/07.rst | 51 +++++++++++++++++++-- 2 files changed, 142 insertions(+), 50 deletions(-) diff --git a/esempi/06.rst b/esempi/06.rst index a9794aa..c61dbd2 100644 --- a/esempi/06.rst +++ b/esempi/06.rst @@ -1,48 +1,95 @@ -======= -Tabelle -======= - -Esistono tre modi di disegnare tabelle: due più semplici, ma limitati -ed un'altro più completo, ma noioso da scrivere, nel quale viene -disegnata tutta la griglia con caratteri ascii. - -====================== ======== ========= ========= - Caratteristiche Tipo di tabella ----------------------- ---------------------------- - disponibili Semplice A griglia Ad elenco -====================== ======== ========= ========= -Facili da scrivere SI NO SI -Caselle su più colonne SI SI NO -Caselle su più righe NO SI NO -Paragrafi nelle celle NO SI SI -====================== ======== ========= ========= - -.. list-table:: Tabella ad elenco - :widths: 10 20 20 - :header-rows: 1 - :stub-columns: 1 - - * - Titolo 1 - - Titolo 2 - - Titolo 3 - * - semplici - - testo 1 - - testo 2 - * - blocchi - - + un - + semplice - + elenco - - un piccolo paragrafo, che comunque dovrebbe occupare più di una - semplice riga di testo, a meno che non lo si visualizzi in html - su un monitor molto largo. - -+----------+----------+---------+ -| Titolo 1 | Titolo 2 | Titolo3 | -+==========+==========+=========+ -| Casella | Casella larga | -+----------+----------+---------+ -| Casella | - a | 1 | -| su più | - b +---------+ -| righe | - c | 2 | -+----------+----------+---------+ +============================== +Estensioni di reStructuredText +============================== + +reStructuredText comprende dei metodi per aggiungere nuove funzionalità +senza dover introdurre nuove forme di sintassi. +Molte costruzioni standard sono state implementate in questi modi. + +Direttive +========= + +Una direttiva è composta dall'inizio di markup esplicito seguito +dal nome della direttiva e da un blocco di contenuti. +Un elenco di campi all'inizio dei contenuti permette di specificare +eventuali opzioni della direttiva. + +.. note:: + Un'utile tipo di direttiva segnala che un blocco è di tipo + particolare; spesso vengono renderizzati con uno stile che + li separa dal resto del documento, magari con uno sfondo + più scuro o un contorno. + +.. tip:: + Alcune direttive di questo tipo disponibili sono: + + * attention + * caution + * danger + * error + * hint + * important + * note + * tip + * warning + +.. admonition:: Ma non solo! + :class: and_also + + C'è anche la possibilità di specificare un titolo a piacere. + +.. sidebar:: Sidebar + :subtitle: colonna a lato + + La direttiva ``sidebar`` offre la possibilità di specificare + dei contenuti “paralleli” al resto del testo. + +.. container:: myclass + + ``container`` è l'equivalente di ``
`` in HTML: un modo generico + per specificare che alcuni contenuti vanno raggruppati per + applicare loro determinate proprietà. + +Gli interpreti reStructuredText supportano molte altre direttive, +alcune delle quali verranno presentate in esempi successivi. + +Sostituzioni +============ + +In |reST|_ si possono definire delle stringhe che verranno sostituite +con un'opportuna direttiva. Vedremo più avanti come usarlo con +delle immagini, mentre un altro esempio ampiamente supportato +permette sostituzione di testo, magari lungo e scomodo da scrivere +tutte le volte come |reST|. + +.. |reST| replace:: reStructuredText +.. _reST: http://docutils.sourceforge.net/rst.html + +Le sostituzioni sono definite con:: + + .. || nome_della_direttiva:: contenuti della direttiva + +e vengono richiamate nel testo con ``||``. + +Testo interpretato +================== + +Il testo racchiuso tra apici rovesciati viene associato ad un ruolo che +può essere implicito o esplicitato con un identificativo racchiuso +tra due caratteri ``:``. + +Anche in questo caso è possibile definire i propri ruoli, ma ne esistono +alcuni generalmente disponibili, tra cui i seguenti esempi. + +``pep-reference`` + Si possono richiamare delle Python Enhancement Proposal con + :pep-reference:`287` (o più brevemente :PEP:`287`). +``rfc-reference`` + Simile alla precedente, riferita alle Internet Request for comment: + :rfc-reference:`1149` o :RFC:`2549`. +``subscript`` e ``superscript`` + Testo a :subscript:`pedice` e ad :superscript:`apice` rispettivamente. + Per separare il testo interpretato senza far apparire spazi + estranei si può usare uno spazio preceduto da barra rovesciata; + ad esempio a\ :sub:`0`\ :sup:`2`. diff --git a/esempi/07.rst b/esempi/07.rst index b560bf3..a9794aa 100644 --- a/esempi/07.rst +++ b/esempi/07.rst @@ -1,3 +1,48 @@ -========= -Direttive -========= +======= +Tabelle +======= + +Esistono tre modi di disegnare tabelle: due più semplici, ma limitati +ed un'altro più completo, ma noioso da scrivere, nel quale viene +disegnata tutta la griglia con caratteri ascii. + +====================== ======== ========= ========= + Caratteristiche Tipo di tabella +---------------------- ---------------------------- + disponibili Semplice A griglia Ad elenco +====================== ======== ========= ========= +Facili da scrivere SI NO SI +Caselle su più colonne SI SI NO +Caselle su più righe NO SI NO +Paragrafi nelle celle NO SI SI +====================== ======== ========= ========= + +.. list-table:: Tabella ad elenco + :widths: 10 20 20 + :header-rows: 1 + :stub-columns: 1 + + * - Titolo 1 + - Titolo 2 + - Titolo 3 + * - semplici + - testo 1 + - testo 2 + * - blocchi + - + un + + semplice + + elenco + - un piccolo paragrafo, che comunque dovrebbe occupare più di una + semplice riga di testo, a meno che non lo si visualizzi in html + su un monitor molto largo. + ++----------+----------+---------+ +| Titolo 1 | Titolo 2 | Titolo3 | ++==========+==========+=========+ +| Casella | Casella larga | ++----------+----------+---------+ +| Casella | - a | 1 | +| su più | - b +---------+ +| righe | - c | 2 | ++----------+----------+---------+ + -- cgit v1.2.3