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 obtener el documento
El documento PDF es generado regularmente y está disponible en la sección de descargas de este sitio web. Además, se puede descargar el código XML que sirve para generar la documentación en formatos HTML y PDF.
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