Estensioni di reST

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 ``<div>`` 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::
+
+   .. |<testo da sostituire>| nome_della_direttiva:: contenuti della direttiva
+
+e vengono richiamate nel testo con ``|<testo da sostituire>|``.
+
+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       |
++----------+----------+---------+
+