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.

System Message: ERROR/3 (esempi/12.rst, line 15)

Unknown directive type "code".

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

System Message: ERROR/3 (esempi/12.rst, line 28)

Error in "include" directive: unknown option: "number-lines".

.. include:: hello.py
   :literal:
   :start-line: 2
   :number-lines:
   :code: python