Generar documentación de Symfony2

Si queremos aprender a trabajar con Symfony no hay nada como acceder a la documentación oficial. Sin embargo, puede que no estemos online en un momento dado o que simplemente querramos disponer de la documentación en un formato portable para visualizarla cómodamente en una tablet o un ebook. En estas breves líneas aprenderemos a generarnos la documentación en formato HTML o PDF a partir del repositorio Github
Para empezar, mencionar que todo esto lo estoy realizando desde Ubuntu 11.04. Bien, lo primero que haremos será instalar las herramientas necesarias: Sphinx y Tex Live.

sudo apt-get install python-setuptools
sudo easy_install -U Sphinx
sudo apt-get install texlive-full

Una vez hecho esto, nos descargamos la documentación de Symfony2 y la extensión de Sphinx creada por Fabien Potencier.

git clone https://github.com/symfony/symfony-docs.git
git clone https://github.com/fabpot/sphinx-php.git

Ahora tenemos que ejecutar el asistente de configuración de Sphinx, pero antes de eso, vamos a renombrar el fichero index.rst dentro de symfony-docs con cualquier otro nombre, ya que el asistente nos va a generar otro fichero index.rst.

sphinx-quickstart

Dejamos todas las opciones por defecto, excepto la extensión autodoc, que deberemos activarla. Una vez completado el asistente, borramos el fichero index.rst y volvemos a renombrar el fichero original.
Ya sólo nos queda instalar la extensión para Sphinx creada por Fabien: configuration-block. Para ello, dentro del directorio symfony-docs creamos un nuevo directorio _exts y copiamos dentro el fichero configurationblock.py. Ahora buscamos el fichero conf.py y justo después de añadimos

sys.path.append(os.path.abspath('_exts'))

después buscamos el array de extensiones y añadimos el configurationblock

extensions = ['sphinx.ext.autodoc', 'configurationblock']

Bien, todo listo, ahora sólo hay que generar la documentación

make html
make latexpdf

y buscarla en el directorio _build.