aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorElena ``of Valhalla'' Grandi <elena.valhalla@gmail.com>2012-03-26 07:08:14 +0200
committerElena ``of Valhalla'' Grandi <elena.valhalla@gmail.com>2012-03-26 07:08:14 +0200
commitbddbf5e952b99f999adb9c5a1a7f26dbf013c13c (patch)
tree24b900c5f9b83aeaee18d3aba91c82f9eb012502
parent45574a5b4a5e78b0fac0987ecc259344ee54245e (diff)
Elenchi: elenchi di altro tipo e correzioni sintassi
-rw-r--r--esempi/04.rst28
1 files changed, 28 insertions, 0 deletions
diff --git a/esempi/04.rst b/esempi/04.rst
index 782eecd..fa0bf6b 100644
--- a/esempi/04.rst
+++ b/esempi/04.rst
@@ -2,6 +2,9 @@
Elenchi
=======
+Elenchi comuni
+==============
+
reStructuredText supporta i consueti tipi di elenchi:
* puntati;
@@ -12,10 +15,12 @@ Gli elenchi puntati e numerati rispettano le seguenti condizioni.
1. Sono separati dagli altri paragrafi con una riga vuota.
2. Ogni elemento inizia con un carattere opportuno:
+
- per gli elenchi puntati "*", "-" o "+";
- per gli elenchi numerati un numero seguito da un punto;
- per gli elenchi numerati in modo automatico si può usare
il carattere "#" al posto del numero, sempre seguito da un punto.
+
Questi caratteri devono essere seguiti da uno spazio.
#. Tra gli elementi può esserci una riga vuota, ma non è obbligatorio.
#. Elementi più lunghi di una riga possono continuare sulla riga
@@ -31,3 +36,26 @@ Definizione
Non possono esserci righe vuote tra il termine e la sua definizione;
possono invece essercene tra una definizione e il termine successivo.
+Altri elenchi
+=============
+
+reStructuredText prevede altri due tipi di elenchi meno comuni.
+
+:Tipo elenco: Elenco di campi
+:Uso: Campi usabili come opzioni per le direttive di espansione
+ di reStructuredText, o in generale in fase di post-processing.
+
+ Possono anche essere usati semplicemente come una tabella
+ a due colonne.
+
+L'altro tipo di elenco è più specifico e serve per documentare le
+opzioni dei programmi a riga di comando; in questo caso le
+opzioni e la loro descrizione sono separate da almeno due spazi.
+
+-a un'opzione
+-b <file> un'opzione con parametro e descrizione che richiede
+ più di una riga di testo
+--option un'opzione lunga
+--file=<file> un'opzione lunga con parametro
+/V un'opzione stile DOS
+