docbook:index
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
docbook:index [2009/02/20 21:55] – rlunaro | docbook:index [2012/02/03 22:54] – rlunaro | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Docbook ====== | ||
- | |||
- | Cómo instalar Docbook en un sistema windows para generar documentos en html (una sóla página o varias páginas), chm, pdf y rtf (para Word). | ||
- | |||
- | Las presentes páginas las he creado para documentar mis progresos: cómo crear desde cero un sistema de procesado de documentos y también cómo conseguir el objetivo propuesto de obtener varios formatos. Además lo quiero en Windows y Linux y que me soporte Unicode (porque soportaré documentos en varios idiomas, no necesariamente Western European). | ||
- | |||
- | ===== Máquina virtual java ===== | ||
- | |||
- | Es preciso tener la máquina virtual java, así que recomiendo | ||
- | que nos hagamos una descarga de http:// | ||
- | con la instalación. | ||
- | |||
- | ===== Necesitamos un procesador de XSLT ===== | ||
- | |||
- | Bueno, no sé muy bien lo que es, pero necesitamos un procesador de xslt. Hay varios disponibles ((Tomado de http:// | ||
- | |||
- | Me he decantado por xsltproc. Puede descargarse para windows [[http:// | ||
- | |||
- | * iconv | ||
- | * libxmlsec | ||
- | * openssl | ||
- | * libxml2 | ||
- | * libxslt | ||
- | * zlib | ||
- | |||
- | Para juntarlos todos, descomprimalos y el contenido de las carpetas | ||
- | " | ||
- | |||
- | Yo he creado un paquete xsltproc_todo.zip que ya lo contiene así. Hemos incluido la | ||
- | ruta al programa " | ||
- | ventana de comandos, basta con escribir " | ||
- | |||
- | < | ||
- | c:\> xsltproc | ||
- | </ | ||
- | |||
- | Nos tiene que salir la ayuda del programa. | ||
- | |||
- | |||
- | ==== Descargando las hojas de estilo XSL de DocBook ==== | ||
- | |||
- | Esto es realmente DocBook: unas hojas de estilo que nos permiten procesar un documento DocBook (que está en xml) para obtenerlo en un formato " | ||
- | |||
- | Las hojas de estilo se descargan del [[http:// | ||
- | |||
- | La primera prueba sencilla. | ||
- | |||
- | Hemos creado un libro muy sencillo: | ||
- | |||
- | <code xml> | ||
- | <book lang=" | ||
- | < | ||
- | < | ||
- | </ | ||
- | <toc> | ||
- | </ | ||
- | <!-- Los comentarios tienen este aspecto --> | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | |||
- | Para generar la salida en formato html: | ||
- | |||
- | < | ||
- | C: | ||
- | </ | ||
- | |||
- | Para generar la salida en formato html help de microsoft: | ||
- | |||
- | < | ||
- | xsltproc --output prueba.html --stringparam use.extensions 0 / | ||
- | </ | ||
- | |||
- | |||
- | Obtendremos un fichero html único. | ||
- | |||
- | |||
- | ==== Pasos adicionales para generar un fichero rtf o pdf ==== | ||
- | |||
- | Hay que instalarse una utilidad que se llama FOP. | ||
- | |||
- | Esta utilidad, desarrollada por apache, puede descargarse del sitio | ||
- | web de apache en http:// | ||
- | |||
- | En concreto el fichero fop-0.95-bin.zip. | ||
- | |||
- | Lo he descomprimido en archivos de programa y he puesto la ruta | ||
- | al programa " | ||
- | |||
- | |||
- | |||
- | HACEMOS UN FICHERO BAT QUE HACE LA COMPILACION DE UN DOCUMENTO EN WINDOWS | ||
- | |||
- | <code bat> | ||
- | rem | ||
- | rem compilar - genera el libro en varios formatos: chm, html_single, | ||
- | rem | ||
- | |||
- | set document=minibook | ||
- | |||
- | set docbook=C: | ||
- | |||
- | set XML_CATALOG_FILES=%docbook%\catalog.xml | ||
- | |||
- | rem | ||
- | rem HTML una sola pagina | ||
- | rem | ||
- | set dest_folder=html_single | ||
- | rem copiamos todo el contenido de la carpeta images a la carpeta | ||
- | rem de destino dest_folder | ||
- | xcopy images %dest_folder%\images /e /i /y | ||
- | xsltproc --output " | ||
- | |||
- | |||
- | rem | ||
- | rem HTML multipágina | ||
- | rem | ||
- | set dest_folder=html_multi | ||
- | rem copiamos todo el contenido de la carpeta images a la carpeta | ||
- | rem de destino dest_folder | ||
- | xcopy images %dest_folder%\images /e /i /y | ||
- | xsltproc --output " | ||
- | |||
- | rem | ||
- | rem CHM (ayuda de microsoft) | ||
- | rem | ||
- | set dest_folder=chm | ||
- | rem copiamos todo el contenido de la carpeta images a la carpeta | ||
- | rem de destino dest_folder | ||
- | xcopy images %dest_folder%\images /e /i /y | ||
- | xsltproc --output " | ||
- | |||
- | REM rem | ||
- | REM rem RTF | ||
- | REM rem | ||
- | REM set dest_folder=rtf | ||
- | REM rem copiamos todo el contenido de la carpeta images a la carpeta | ||
- | REM rem de destino dest_folder | ||
- | REM xcopy images %dest_folder%\images /e /i /y | ||
- | REM xsltproc --output " | ||
- | REM fop " | ||
- | |||
- | |||
- | rem | ||
- | rem PDF | ||
- | rem | ||
- | set dest_folder=pdf | ||
- | rem copiamos todo el contenido de la carpeta images a la carpeta | ||
- | rem de destino dest_folder | ||
- | xcopy images %dest_folder%\images /e /i /y | ||
- | xsltproc --output " | ||
- | fop " | ||
- | </ | ||
- | |||
- | |||
- | |||
- | ==== Otros ficheros que me he descargado ==== | ||
- | |||
- | **xmlNotepad**: | ||
- | del sitio web de descargas de microsoft http:// | ||
- | |||
- | **Microsoft HTML Help Compiler**: compilador de ayudas de microsoft, para | ||
- | generar los archivos de ayuda de microsoft (*.chm). | ||
- | |||
- | **Manual de referencia de docbook**: puede descargarse de esta | ||
- | página web http:// | ||
- | |||
- | Hay dos ficheros: uno es el fichero " | ||
- | en formato chm, y el otro viene en formato zip: tdg5-0.0.25.zip. | ||
- | |||
- | |||
docbook/index.txt · Last modified: 2022/12/02 22:02 by 127.0.0.1