Tutorial de DocBook: Un enfoque integrado y a través de ejemplos | ||
---|---|---|
Anterior | Capítulo 2. Escribiendo un ejemplo básico | Siguiente |
Antes de generar cualquier tipo de documento[1] a partir de la fuente SGML, es necesario que se trate de un documento válido, es decir que se respete la sintaxis de DocBook. Para ello basta usar el comando Control+c Control+v Enter[2] , dividiéndose la ventana y apareciendo un mensaje que indica el resultado de la validación exitosa. Más explícitamente dicho mensaje es:[3]
cd /home/irving/20013/doc-tut/e1 nsgmls -s hola.sgml SGML validation finished at Sat Jun 16 07:38:03 |
Actualmente existen muchas herramientas DocBook a diversos formatos, pero muy probablemente dentro de su sistema Linux usted contará con las siguientes: [4]
db2html, para traducir de DocBook a HTML
db2ps, para traducir de DocBook a PS
db2pdf, para traducir de DocBook a PDF
db2rtf, para traducir de DocBook a RTF
El uso de tales herramientas es bastante sencillo, simplemente desde la línea de comandos, basta escribir por ejemplo db2html nomarch. A continuación mostramos explícitamente como producir documentos en formato HTML y PS respectivamente
Dentro de emacs se puede hacer un llamado a la línea de comandos usando ESC !, por lo tanto si queremos generar un documento HTML, basta usar ESC ! y luego digitar db2html hola.sgml. A continuación se dividirá la pantalla y en la segunda de ellas se obtendrá un resultado del siguiente estilo
TMPDIR is DBTOHTML_OUTPUT_DIR4724 input file was called hola.sgml -- output will be in hola working on ../hola.sgml about to copy cascading stylesheet and admon graphics to temp dir about to rename temporary directory to hola |
Dicha aplicación creará un directorio hola, en donde almacenará el conjunto de páginas que conforman su documento. La página principal, contendrá la tabla de contenidos de su documento y se llamará book1.html, en nuestro caso dicha página luce de la siguiente forma
De igual forma, si hacemos click en el link de Siguiente, obtenemos que la página del primer capítulo luce de la siguiente forma:
En caso de que se quiera generar el documento en formato PS basta usar ESC ! y luego digitar db2ps hola.sgml
En la mitad inferior de emacs se obtendrá un conjunto de mensajes que indican que se está generando el documento [5], las últimas líneas de este mensaje lucen de la siguiente forma
Output written on hola.dvi (4 pages, 26792 bytes). Transcript written on hola.log. This is dvips(k) 5.86 Copyright 1999 Radical Eye Software (www.radicaleye.com) ' TeX output 2001.06.16:0857' -> hola.ps <texc.pro><8r.enc><texps.pro><special.pro><color.pro>. [1] [2] [3] [4] |
Esto generará el archivo hola.ps, el cuál puede ser visualizado usando GhostView, para verlo use ESC !, y luego gv hola.ps&. Una vez hecho esto obtendrá una pantalla como la siguiente>
Avanzando de página, obtendremos que el primer capítulo luce de la siguiente forma
El proceso de generar PDF y RTF es muy similar a lo visto hasta el momento, por lo tanto no lo describiremos.
[1] | Hay que recordar que se pueden generar documentos en formato HTML, PS, PDF y RTF |
[2] | En caso de que no haya salvado aparecerá un mensaje en el buffer pidiéndole que lo haga, para lo cual debe escribir y. |
[3] | Una vez leido este mensaje es muy probable que desee salirse del modo de dos ventanas, para ello teniendo el cursor en la ventana superior, use Control+X 1 |
[4] | Cabe anotar que en la distribución Debian no se tienen herramientas con estos nombres. En vez de éstas se usa sgmltools con opciones apropiadas. Por ejemplo en vez de escribir db2html hola.sgml, se usa sgmltools -b html hola.sgml o en vez de db2ps hola.sgml se usa sgmltools -b ps hola.sgml |
[5] | Algunos de ellos son errores como l.42 \select@language{spanish} , que son ignorados la mayor parte del tiempo |