From 3e6038ea5f23d4fd22d42f5561092d4dc17d387f Mon Sep 17 00:00:00 2001 From: Elena ``of Valhalla'' Grandi Date: Mon, 26 Mar 2012 12:26:22 +0200 Subject: Codice sorgente --- esempi/12.rst | 28 ++++++++++++++++++++++++++++ esempi/hello.py | 6 ++++++ 2 files changed, 34 insertions(+) create mode 100644 esempi/hello.py 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 diff --git a/esempi/hello.py b/esempi/hello.py new file mode 100644 index 0000000..0f2c124 --- /dev/null +++ b/esempi/hello.py @@ -0,0 +1,6 @@ +#!/usr/bin/env python + +def main(): + print "Hello World!" + +if __name__ == '__main__': main() -- cgit v1.2.3