blob: 34ed5fbcd63fcc5c7f62efce96fdb6cac2adbac2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
===============
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
|