===============
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