Instalación
Sin importar el uso de sgml o xml y como ya está descrito en el artículo de DocBook, no debemos ver esta herramienta como una aplicación a lanzar desde algún menu o con algún comando, entonces para trabajar con este sistema de documentación debemos usar un editor de texto que soporte edición de xml (incluso puede ser uno de texto plano pero no es recomendado), por ejemplo emacs tiene modos que soportan tanto sgml como xml.
Los paquetes a instalar dependiendo de si se quiere usar xml o sgml son (puede instalar todos los paquetes al tiempo):
XML
Significado de las siglas XML (eXtensible Markup Language) o Lenguaje de Marcado eXtensible
- nxml-mode
Este es el modo XML para emacs
- xmlto
- Frontend para el procesador XSLT xsltproc, este paquete tiene como dependencias docbook-xml que es la dtd y esquemas docbook-xsl que son las hojas de estilo para xml y xsltproc que es un procesador XSLT (generar distintos formatos de salida)
- fop
- Conversor de xml a pdf, este paquete es contrib.
- dblatex
Convierte de DocBook a DVI, PS, PDF procesando con LaTeX.Tambien funciona con documentos sgml.
SGML
Significado de las siglas SGML (Standard Generalized Markup Language) o Lenguaje de Marcación Generalizado
- psgml
Este es el modo SGML para emacs pero tambien puede ser usado para editar xml como se muestra en http://wiki.debian.org/EmacsDocBookXMLSpanish
- docbook
- La DTD sgml para docbook.
- docbook-utils
Scripts necesarios para convertir el documento sgml a html, rtf, ps, man, pdf. Tambien funciona con documentos xml. Este tiene como dependencia a docbook-dsssl que son las hojas de estilo modulares dsssl para presentaciónes en impresión y html.
Uso
Para usarlo solamente ejecute emacs de la siguiente forma:
$ emacs nombre.sgml
Cuando cargue el editor copie y pegue la siguiente línea
<!DOCTYPE ARTICLE PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
Y oprima:
C-c C-p
Y se demorará un rato cargando todo el dtd.
Para insertar un tag, solo digite:
C-c C-e
Y escribe el nombre del tag, si no lo sabe puede utilizar la función de auto completar con el tabulador.