diff options
Diffstat (limited to 'esempi/12.rst')
-rw-r--r-- | esempi/12.rst | 28 |
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 |