Herramientas

Instalación de Jade

1. Lea las instrucciones de instalación en la URL mostrada arriba.

2. Descomprima la distribución con unzip en el lugar adecuado . El comando para para hacer esto puede ser como este:

   unzip -aU jade1_1.zip

3. Jade no ha sido construido usando GNU autoconf, de modo que tendrá que editar un Makefile por su cuenta. Ya que James Clark ha sido lo suficientemente bueno como para preparar su kit para ello, es una buena idea crear un directorio (con un nombre como la aquitectura de su máquina, por ejemplo) bajo el directorio principal de Jade, copiar desde él el fichero Makefile al directorio recién creado, editarlo y desde ahí mismo ejecutar make.

   Makefile necesitar ser. Hay un fichero llamado Makefile.jade en el directorio principal cuyo cometido es ser usado con make -f Makefile.jade cuando se construye Jade (a diferencia de SP, el parser SGML sobre el que está construido Jade). Aconsejamos que no se haga esto, ya que deberá cambiar más cosas que lo que hay en Makefile.jade.

   Recorra el fichero Makefile, leyendo las instrucciones de Jame y haciendo los cambios necesarios. Hay algunas variables que necesitan ser fijadas. Aquí se muestra un sumario de las más representativas con sus valores más típicos:

   prefix = /usr/local XDEFINES = -DSGML_CATALOG_FILES_DEFAULT=\"/usr/local/share/sgml/catalog\" XLIBS = -lm RANLIB = ranlib srcdir = .. XLIBDIRS = grove spgrove style XPROGDIRS = jade

   Observe la especificación de dónde encontrar el catálogo SGML por defecto de los ficheros de soporte (quizás tenga que cambiarlo a algo más adecuado para su instalación). Si su sistema no necesita los ajustes mencionados arriba para la librería de funciones matemáticas y para el comando ranlib, déjelos tal y como están en Makefile.

4. Escriba make para compilar Jade y las herramientas de SP.

5. Una vez que esté compilado, make install hará la instalación.

Instalación del DTD de DocBook

1. Es conveniente que emplace los ficheros que constituyen el DTD de DocBook en el directorio en el que compiló Jade, /usr/local/share/sgml/ si ha seguido nuestra recomendación. Además de los ficheros de DocBook, necesitará el fichero catalog en su sitio para el mapa de las especificaciones del tipo de documento y las referencias externas de las entidades a los ficheros actuales en ese directorio. También necesitará el mapa de caracteres ISO y posiblemente una o más versiones de HTML.

   Una manera para instalar las diferentes DTD y ficheros de soporte y para ajustar el fichero catalog es juntarlos todos en el directorio mencionado más arriba, usar un único fichero llamado CATALOG que los describa a todos y entonces crear el fichero catalog como un puntero a catalog añadiendo la línea:

   CATALOG /usr/local/share/sgml/CATALOG

2. El fichero CATALOG contendría tres tipos de líneas. La primera (opcional) la declaracion SGML :

   SGMLDECL docbook.dcl

   Después, las diferentes referencias a DTD y ficheros de las entidades. Para los ficheros DocBook las líneas serían como estas:

   PUBLIC "-//Davenport//DTD DocBook V3.0//EN" docbook.dtd PUBLIC "-//USA-DOD//DTD Table Model 951010//EN" cals-tbl.dtd PUBLIC "-//Davenport//ELEMENTS DocBook Information Pool V3.0//EN" dbpool.mod PUBLIC "-//Davenport//ELEMENTS DocBook Document Hierarchy V3.0//EN" dbhier.mod PUBLIC "-//Davenport//ENTITIES DocBook Additional General Entities V3.0//EN" dbgenent.mod

3. Por supuesto que en el kit de DocBook hay un fichero que contiene todo esto. Observe que el último elemento en cada una de esas líneas es un nombre de fichero, que aquí se da sin el path. Puede poner los ficheros en subdirectorios de su directorio SGML si quiere y modificar la referencia en el fichero CATALOG. DocBook también referencia el conjunto de caracteres ISO de las entidades, por lo que necesitará traerlos e instalarlos (están disponibles desde varias fuentes y se pueden encontrar fácilmente en las URLs mostradas más arriba), además de su entradas:

   PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN" ISO/ISOlat1

   Observe que el nombre de fichero contiene un directorio, diciéndonos que hemos puesto los ficheros de entidades ISO en un subdirectorio ISO. Nuevamente las entradas oportunas en el catálogo deben acompañar a la entidad que se haya traído.

Instalación de las hojas de estilo DSSSL de Norman Walsh

1. Lea las instrucciones de instalación en la URL mostrada más arriba.

2. Para instalar las hojas de estilo de Norman, simplemente descomprima los ficheros de la distribución en el lugar adecuado. Un buen lugar para hacerlo sería /usr/local/share, que emplaza los los ficheros en un directorio bajo /usr/local/share/docbook. El comando sería algo parecido a esto:

   unzip -aU db119.zip

3. Una manera de probar la instalación es compilar los formularios HTML y RTF de la Guía de usuarios de PostgreSQL.

   1. Para compilar los ficheros HTML vaya al directorio fuente de SGML , doc/src/sgml, y escriba

      jade -t sgml -d /usr/local/share/docbook/html/docbook.dsl -D ../graphics postgres.sgml

      book1.htm es el nodo más alto de la salida...

   2. Para generar el RTF preparado ser importado a su procesador de textos favorito, escriba:

      jade -t rtf -d /usr/local/share/docbook/print/docbook.dsl -D ../graphics postgres.sgml

Instalación de PSGML

1. Lea las instrucciones de instalación en la URL mostrada más arriba.

2. Desempaquete el fichero de la distribución, ejecute configure, make y make install para colocar en su sitio los ficheros compilados y las librerías.

3. Después añada las líneas siguientes al fichero /usr/local/share/emacs/site-lisp/site-start.el de modo que Emacs pueda cargar correctamente PSGML cuando lo necesite:

   (setq load-path (cons "/usr/local/share/emacs/site-lisp/psgml" load-path)) (autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t)

4. Si necesita usar PSGML cuando también esté editando HTML añada esto:

   (setq auto-mode-alist (cons '("\\.s?html?\\'" . sgml-mode) auto-mode-alist))

5. Hay una cosa importante que debe tener en cuenta con PSGML: su autor asume que su directorio principal para el DTD SGML es /usr/local/lib/sgml. Si, como en los ejemplos de capítulo, utiliza /usr/local/share/sgml, debe corregirlo adecuadamente.

   1. Puede fijar la variable de entorno SGML_CATALOG_FILES.

   2. Puede personalizar su instalación de PSGML (el manual le dirá cómo).

   3. Puede incluso editar el fichero fuente psgml.el antes de compilar e instalar PSGML, de modo que cambie los path para que se adecuen a los suyos por defecto.