=============================
 reStructuredText per esempi
=============================

Requisiti e compilazione
------------------------

Per compilare gli esempi in vari formati sono necessari python
e docutils_. Inoltre per il formato pdf è necessaria una distribuzione
di TeX completa di xeTeX, ad esempio `TeX Live`_.

.. _docutils: http://docutils.sourceforge.net/
.. _`TeX Live`: http://www.tug.org/texlive/

Tutti i documenti possono essere compilati in vari formati con 
i programmi rst2* di docutils, ma per semplicità si può usare::

   ./build.py [-H] [-p] [-o] <sezione> [<sezione>]

dove ``-H``, ``-p`` e ``-o`` compilano rispettivamente in html, pdf 
ed odt, e ``<sezione>`` può essere ``esempi`` o ``strumenti``.

Alcuni esempi non compilano in tutti i formati supportati da 
docutils, dato che illustrano caratteristiche non sempre disponibili.

In alternativa, si possono compilare gli esempi con pandoc_, usando::

   ./pandoc_build.sh [-H] [-l] [-p] [-e] <sezione> [<sezione>]

anche in questo caso per ottenere PDF è necessario avere installato 
xeTeX.

.. _pandoc: http://johnmacfarlane.net/pandoc/

Licenza
-------

Copyright (C) 2012 Elena Grandi

Quest'opera è stata rilasciata con licenza Creative Commons Attribuzione -
Condividi allo stesso modo 3.0 Italia. Per leggere una copia della licenza
visita il sito web `<http://creativecommons.org/licenses/by-sa/3.0/it/>`_ o
spedisci una lettera a Creative Commons, 171 Second Street, Suite 300, San
Francisco, California, 94105, USA.