Leeme del libro LFS

Este deocumento est orientado a instruir al usuario sobre cmo convertir las
fuentes XML del libro en otros formatos (por ejemplo, HTML, PDF, PS y TXT).
Primero, si todava no lo has hecho, lee en el fichero INSTALL cmo instalar el
software necesario. Si has completado los pasos indicados en el fichero INSTALL,
contina leyendo aqu los ejemplos sobre cmo convertir estos focheros a otros
formatos diferentes.

De XML a HTML:
--------------
Crea un directorio en el que desees guardar los ficheros HTML y accede a l.
Ahora ejecuta:

	mkdir -p chapter0{1,2,3,4,5,6,7,8,9} preface appendix{a,b} &&
	/usr/bin/openjade -t xml \
		-d /usr/share/dsssl/docbook/html/lfs.dsl \
		/usr/share/dsssl/docbook/dtds/decls/xml.dcl \
		/path/to/index.xml

De XML a NOCHUNKS-HTML:
-----------------------
La versin NOCHUNKS HTML es un gran fichero HTML:
	/usr/bin/openjade -t sgml \
		-V nochunks \
		-d /usr/share/dsssl/docbook/html/lfs.dsl \
		/usr/share/dsssl/docbook/dtds/decls/xml.dcl \
		/path/to/index.xml > nochunks.html

Nota del equipo de lfs-es: Este comando slo nos funciona si se ejecuta con
posterioridad al anterior y estando dentro del mismo directorio.

NOTA PARA LA VERSIN EN CASTELLANO
_____________________________________

Nuestro idioma incluye una serie de caracteres que no se
encuentran recogidos en la tabla ASCII de 7 bits. Estos caracteres son las
vocales acentuadas, la letra  y los smbolos  y . Para su correcta
visualizacin en las pginas HTML los estndares establecen que se representen
mediante un cdigo especfico. Por ejemplo, la  corresponde al cdigo &aacute;,
etc...

Complementariamente, hay un par de etiquetas HTML que no se generan
correctamente y provocan ciertos problemas de visualizacin de las pginas en
algunos navegadores web. Tambin provocan que no se formateen correctamente
ciertas secciones al generar los formatos en PDF y PS.

Para solucionar estas cosas nosotros usamos un guin del intrprete de comandos que se
encarga de hacer estas modificaciones. Debes ejecutar este guin tras generar los
documentos HTML con openjade, y antes de crear los otros formatos con lynx/links y
htmldoc.

Dicho guin es el siguiente:

#!/bin/bash -e

NAME=`basename $0`

if [ -z "$1" ]; then
        echo "USO: $NAME /ruta/al/directorio"
        exit
fi

for filename in `find $1 -name "*.html"`; do
        sed -e 's//\&aacute;/g' \
                -e 's//\&eacute;/g' \
                -e 's//\&iacute;/g' \
                -e 's//\&oacute;/g' \
                -e 's//\&uacute;/g' \
                -e 's//\&Aacute;/g' \
                -e 's//\&Eacute;/g' \
                -e 's//\&Iacute;/g' \
                -e 's//\&Oacute;/g' \
                -e 's//\&Uacute;/g' \
                -e 's//\&ntilde;/g' \
                -e 's//\&Ntilde;/g' \
                -e 's//\&iquest;/g' \
                -e 's//\&iexcl;/g' \
                -e 's%<br/>%<br />%g' \
                -e 's%<BR/>%<BR />%g' "${filename}" > "${filename}.backup"

        mv "${filename}.backup" "${filename}"
done

# Fin del fichero


De XML a TXT:
-------------
Primero crea el fichero NOCHUNKS HTML, luego convirtelo ejecutando:
	/usr/bin/lynx -dump nochunks.html > fichero_salida.txt


De XML a PS y PDF:
--------------------
Primero crea el fichero NOCHUNKS HTML, luego convirtelo usando htmldoc. Puedes
usar la GUI y seleccionar las opciones. Si ests satisfecho con las opciones por
defecto, ejecuta el siguiente comando:

	/usr/bin/htmldoc --book --firstpage p1 -v -t <tipo> \
		-f <salida> nochunks.html

reemplaza <tipo> por pdf13 para crear un fichero pdf, o por ps3 para crear un
fichero ps. Existen otros niveles de pdf y ps. Tienes ms opciones en la pgina
del manual. Reemplaza <salida> con el nombre del fichero ps o pdf que
desees generar.

