Tareas #76
Transformaciones desde Docbook
100%
Descripción
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:
Ficheros
Histórico
Actualizado por Molina Coballes, Alberto hace casi 12 años
Actualizado por Enlace interesante:
http://www.vineetmanohar.com/2010/02/maven-docbook-for-beginners/
Actualizado por Molina Coballes, Alberto hace más de 11 años
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 :-/
Actualizado por Roca Alhama, Alejandro hace más de 11 años
Actualizado por Roca Alhama, Alejandro hace Se puede intentar, tengo los ficheros que se usan localizados. Los miro y os digo algo.
Actualizado por Molina Coballes, Alberto hace más de 11 años
- Añadido Fichero bk-admin-openstack.pdf bk-admin-openstack.pdf
- Estado cambiado de Nueva a En curso
- % Realizado cambiado de 0 a 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.
Actualizado por Moreno León, Jesús hace más de 11 años
Actualizado por Moreno León, Jesús hace 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?
Actualizado por Molina Coballes, Alberto hace más de 11 años
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 ...
Actualizado por Molina Coballes, Alberto hace más de 11 años
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
Actualizado por Molina Coballes, Alberto hace más de 11 años
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.
Actualizado por Molina Coballes, Alberto hace más de 11 años
- Estado cambiado de En curso a Resuelta
- % Realizado cambiado de 90 a 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.