Introducción

Este proyecto consiste en un texto libre y en español sobre el desarrollo y empaquetamiento de programas para sistemas basados en Debian GNU/Linux (en particular, Ubuntu).

La idea es documentar el proceso de desarrollo de aplicaciones de escritorio sencillas escritas en lenguajes como Python o Java, usando Glade; y además del trabajo que se requiere para tomar el código de la aplicación y convertirlo en un paquete de software instalable desde un repositorio.

Estas tareas adicionales al desarrollo permitirán que los usuarios de una aplicación puedar obtener de forma automática las ultimas actualizaciones de nuestra aplicación.

Cómo generar la documentación en formato HTML

1.- Debes estar seguro de tener instalados los paquetes xsltproc, docbook-xsl y subversion

 $ sudo apt-get install xsltproc docbook-xsl subversion

2.- Obtener el código fuente XML del documento

 $ svn checkout http://desarrollo-ubuntu.googlecode.com/svn/trunk/ desarrollo-ubuntu
 $ cd desarrollo-ubuntu/libro

3.- Generar el libro en formato HTML

 $ xsltproc -o libro.html /usr/share/xml/docbook/stylesheet/nwalsh/xhtml/docbook.xsl libro.xml

El documento libro.html recién generado es el libro en formato HTML.

Generación de la documentación en formato PDF

Además de los paquetes anteriores, se requiere Java y Apache FOP.

1.- Instalar uno de los siguientes paquetes:

• sun-java5-jre (para Java versión 5),
• sun-java6-jre (para Java versión 6),
• icedtea-java7-jre (para usar Java versión 7).

 $ sudo apt-get install sun-java5-jre
 $ sudo update-alternatives --config java

2.- Descargar y descomprimir Apache FOP (unos 20 Megabytes)

 $ wget -c http://www.apache.org/dist/xmlgraphics/fop/fop-current-bin-jdk1.4.zip
 $ unzip fop-current-bin-jdk1.4.zip
 $ chmod a+x fop-0.94/fop

3.- Generar el PDF en el directorio donde se encuentran los archivos XML

 $ xsltproc -o libro.fo /usr/share/xml/docbook/stylesheet/nwalsh/fo/docbook.xsl libro.xml
 $ fop-0.94/fop libro.fo libro.pdf