Compilación de la documentación

El curso de programación de Qt ha evolucionado con el tiempo. Inicialmente empezó como un curso enfocado a Ubuntu Touch y poco a poco se ha ido abriendo a las aplicaciones de escritorio. Para hacerlo más sencillo de seguir, junto a otras razones, modificaré un poco la estructura del curso.

Estos cambios afectan tanto a la herramienta que usará el curso, Sphinx, como a la estructura interna de la documentación. En los capítulos se aume que el usuario usa el SDK de Ubuntu. Éste SDK no está disponible actualmente y existen muchas alternativas que corrigen sus problemas. Inicialmente usaré como base el escritorio, y haré los comentarios oportunos para las partes que son exclusivas de Ubuntu Touch.

Aunque pueden parecer muchos cambios, realmente no son muy radicales. El código y la lógica son prácticamente los mismos. Sólo cambian algunos elementos relacionados con Qt»

Aunque continuaré trabajando en el curso a lo largo del mes, subiré la documentación el último viernes de cada mes. En ese momento compilaré la documentación y la subiré a la Web de InnerZaurus.

Instalación

Las instrucciones se aplican a Ubuntu y sus distribuciones derivadas. Los paquetes que se tienen que instalar son:

• build-essential
• Archivos de Sphinx y Python 3

Comandos

sudo apt-get install build-essential
sudo apt-get install python3-sphinx sphinxsearch python3-pip

Extensiones para Sphinx:

pip3 install sphinx-intl
pip3 install --upgrade recommonmark
pip3 install sphinx_rtd_theme

Para compilar la documentación (Inglés):

make html

Para compilar una traducción (Español):

make gettext
sphinx-intl update -p build/gettext -l es
make -e SPHINXOPTS="-D language='es'" html