aboutsummaryrefslogtreecommitdiff
path: root/esempi/12.rst
diff options
context:
space:
mode:
Diffstat (limited to 'esempi/12.rst')
-rw-r--r--esempi/12.rst28
1 files changed, 28 insertions, 0 deletions
diff --git a/esempi/12.rst b/esempi/12.rst
index 2cb95b7..34ed5fb 100644
--- a/esempi/12.rst
+++ b/esempi/12.rst
@@ -2,4 +2,32 @@
Codice sorgente
===============
+Il modo più ovvio per inserire estratti di codice sorgente
+è usare dei blocchi letterali::
+
+ print "Hello World!"
+
+Le versioni di docutils superiori alla 0.9 hanno introdotto la
+direttiva ``code`` che permette di specificare il linguaggio usato,
+ad esempio per poterne evidenziare la sintassi, e specificare se
+mostrare o meno i numeri di riga.
+
+.. code:: python
+ :number-lines: 4
+
+ print "Hello World!"
+
+Purtroppo all'inizio del 2012 questa direttiva non è ancora disponibile
+ovunque, e va quindi usata con cautela.
+
+Un'altra possibilità è richiamare dei file esterni usando l'opzione
+``literal``. Anche in questo caso docutils 0.9 ha introdotto delle
+opzioni per specificare il linguaggio (``code``) e per specificare se
+inserire o meno i numeri di riga.
+
+.. include:: hello.py
+ :literal:
+ :start-line: 2
+ :number-lines:
+ :code: python