Tareas #76
closed
Transformaciones desde Docbook
100%
Description
Una vez generada toda la documentación en Docbook, hay que transformarla a los formatos finales (html, pdf, epub, etc.), por lo que fijándonos en la forma de trabajar del proyecto OpenStack, seguramente optaremos por hacerlo con Apache Maven:
Files
Updated by Molina Coballes, Alberto over 13 years ago
Enlace interesante:
http://www.vineetmanohar.com/2010/02/maven-docbook-for-beginners/
Updated by Molina Coballes, Alberto about 13 years ago
Es necesario modificar el estilo para que aparezca en el título la referencia al proyecto y los logos de la UE y el Mº, además no sé si hay algún inconveniente en que utilicemos el mismo estilo que OpenStack, porque parecería doc oficial y podría dar lugar a equívocos.
¿Sería mucho follón cambiar los colores por algo similar a los de las presentaciones? Yo de Maven estoy tieso :-/
Updated by Roca Alhama, Alejandro about 13 years ago
Se puede intentar, tengo los ficheros que se usan localizados. Los miro y os digo algo.
Updated by Molina Coballes, Alberto about 13 years ago
- File bk-admin-openstack.pdf bk-admin-openstack.pdf added
- Status changed from Nueva to En curso
- % Done changed from 0 to 90
Gracias a las indicaciones de Álex, he podido adaptar la hoja de estilo de OpenStack para Maven a un estilo propio (tomando como base el que hizo Jesús Moreno para las presentaciones). Adjunto el pdf del documento de administración para que veáis que falta muy poco y la apariencia es correcta.
En la portada el texto con el título del proyecto sale una línea desplazada :-m, pero es el únic fallo que he encontrado.
Updated by Moreno León, Jesús about 13 years ago
Ha quedado muy chulo y profesional. Y me parece muy buena idea que el estilo sea similar en las presentaciones y en los documentos.
He visto que algunos títulos aparecen en inglés: Table of contents, List of figures y List of tables. Me imagino que eso será cuestión de cambiar algún valor en la cabecera, no?
Updated by Molina Coballes, Alberto about 13 years ago
Los títulos que aparecen en inglés no encuentro dónde están definidos :-/.
He subido al github el fichero clouddocs-maven-plugin-1.3.1.jar que incluye todas estas configuraciones, es cuestión de bucear un poco ...
Updated by Molina Coballes, Alberto about 13 years ago
Para que se haga correctamente la separación silábica (hyphenation) hay que instalar manualmente el fichero fop-hyph.jar en alguno de los directorios de bibliotecas de la versión de java que se esté utilizando, por ejemplo:
/usr/lib/jvm/java-6-sun-1.6.0.26/jre/lib/ext/fop-hyph.jar
El fichero de "hyphenation" se descarga de http://offo.sourceforge.net/hyphenation/index.html
Updated by Molina Coballes, Alberto about 13 years ago
Los títulos del índice y demás ya salen en castellano :-)
Es necesario especificar el idioma del documento en la etiqueta <book>, poniendo el atributo xml:lang="es"
Creo que sólo falta lo de "de un cloud computing privado para" de la portada que sale desplazado aunque en el svg original esté centrado.
Updated by Molina Coballes, Alberto about 13 years ago
- Status changed from En curso to Resuelta
- % Done changed from 90 to 100
Ya está modificada la portada y se ve correctamente. Creo que con esto se termina el estilo para le pdf (para el html yo utilizaría directamente xsltproc como hacíamos al principio, si queremos utilizar webhelp como la gente de OpenStack hay que meterle mano porque ahora mismo no compila).
Pongo el pdf de infraestructura como ejemplo de cómo queda.