Instalando Docbook DTDs y Herramientas

					OBSOLETA


TÍTULO:			Instalando Docbook DTDs y Herramientas
VERSIÓN LFS:	Cualquiera.
AUTOR:			Tushar Teredesai <Tush@Yahoo.Com>
TRADUCTOR:	Proyecto LFS-ES

SINOPSIS:
	Cómo instalar las herramientas docbook y openjade.

RECETA:

Historial de modificaciones:
[2002-08-07]
	* Realizados algunos cambios para facilitar la actualización.
	* Añadidos varios catálogos más.
[2002-07-08]
	* Primera versión pública.

Prerrequisitos (posterior a LFS):
	* InfoZip Unzip <http://freshmeat.net/projects/unzip/>
	* LibXML <http://freshmeat.net/projects/libxml/>

AVISO:
Esta receta no respeta el límite de 80 columnas en los comandos, pues los
comandos son muy largos y es difícil romper las cadenas sin aplicar una
manipulación innecesaria de variables.

Sitio alternativo:
Estas receta también está disponible en <http://www.geocities.com/tush/lfs>. La
última versión normalmente está disponible aquí.


Instalaremos guiones que nos permitirán centralizar los catálogos SGML y XML y
por tanto no habrá necesidad de establecer la variable SGML_CATALOG_FILES.
La mayoría de los guiones de instalación son directos (instalar el paquete y
después instalar el catalogo). Por tanto no te aburriré con detalles.

En cada una de las siguientes instalaciones, la variable VERSION se refiere a la
versión que estás instalando, y la variable PREVIOUS se refiere a la versión anterior
instalada del paquete. Así que establece las variable de forma correcta. Si es la 
primera vez que instalas los paquetes, no establezcas la variable PREVIOUS. 
establece la variable VERSION  a la versión que estás instalando.

El mejor modo de utilizar las instrucciones es guardarlas en ficheros individuales
y usarlos como fuente.

sgml-common (0.6.3):

* ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/

	./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man
	make
	if [ ! -z ${PREVIOUS} ]
	then
		install-catalog --remove /etc/sgml/sgml-ent.cat /usr/share/sgml/sgml-iso-entities-8879.1986/catalog
		install-catalog --remove /etc/sgml/sgml-docbook.cat /etc/sgml/sgml-ent.cat
	fi
	make install
	install-catalog --add /etc/sgml/sgml-ent.cat /usr/share/sgml/sgml-iso-entities-8879.1986/catalog
	install-catalog --add /etc/sgml/sgml-docbook.cat /etc/sgml/sgml-ent.cat


openjade (1.3.1):

* http://freshmeat.net/projects/openjade/

	./configure --prefix=/usr --enable-http --disable-static
--enable-default-catalog=/etc/sgml/catalog
--enable-default-search-path=/usr/share/sgml
--datadir=/usr/share/sgml/openjade-${VERSION}
	make
	if [ ! -z ${PREVIOUS} ]
	then
		install-catalog --remove /etc/sgml/openjade-${PREVIOUS}.cat /usr/share/sgml/openjade-${PREVIOUS}/catalog
		install-catalog --remove /etc/sgml/openjade-${PREVIOUS}.cat /usr/share/sgml/openjade-${PREVIOUS}/dsssl/catalog
		install-catalog --remove /etc/sgml/openjade-${PREVIOUS}.cat /usr/share/sgml/openjade-${PREVIOUS}/unicode/catalog
		install-catalog --remove /etc/sgml/sgml-docbook.cat /etc/sgml/openjade-${PREVIOUS}.cat
	fi
	make install
	ln -sf onsgmls /usr/bin/nsgmls
	ln -sf openjade /usr/bin/jade
	ln -sf osgmlnorm /usr/bin/sgmlnorm
	ln -sf ospam /usr/bin/spam
	ln -sf ospent /usr/bin/spent
	ln -sf osx /usr/bin/sx
	ln -sf osx /usr/bin/sgml2xml
	install -d /usr/include/OpenSP
	install -m644 generic/*.h /usr/include/OpenSP/
	install -m644 include/*.h /usr/include/OpenSP/
	install -m644 lib/*.h /usr/include/OpenSP/
	echo 'SYSTEM "builtins.dsl" "builtins.dsl"' > /usr/share/sgml/openjade-${VERSION}/catalog
	cp -af dsssl/ pubtext/ /usr/share/sgml/openjade-${VERSION}
	echo "PUBLIC \"-//James Clark//DTD DSSSL Flow Object Tree//EN\" \"fot.dtd\"" >> /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
	echo "PUBLIC \"ISO/IEC 10179:1996//DTD DSSSL Architecture//EN\" \"dsssl.dtd\"" >> /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
	echo "PUBLIC \"-//James Clark//DTD DSSSL Style Sheet//EN\" \"style-sheet.dtd\"" >> /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
	echo "PUBLIC \"-//OpenJade//DTD DSSSL Style Sheet//EN\" \"style-sheet.dtd\"" >> /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
	install-catalog --add /etc/sgml/openjade-${VERSION}.cat /usr/share/sgml/openjade-${VERSION}/catalog
	install-catalog --add /etc/sgml/openjade-${VERSION}.cat /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
	install-catalog --add /etc/sgml/sgml-docbook.cat /etc/sgml/openjade-${VERSION}.cat


docbook-sgml-dtd (3.1 & 4.1)

* http://www.oasis-open.org/docbook/sgml/3.1/index.shtml
* http://www.oasis-open.org/docbook/sgml/4.1/index.shtml
* ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/

	V=${VERSION/.}
	cat docbook-dtd${V}-sgml-1.0.catalog.patch | patch -Np0
	cat docbook-dtd${V}-sgml-1.0.Makefile > Makefile
	make install
	install-catalog --add /etc/sgml/sgml-docbook-dtd${V}.cat /usr/share/sgml/docbook/sgml-dtd-${VERSION}/catalog
	install-catalog --add /etc/sgml/sgml-docbook-dtd${V}.cat /etc/sgml/sgml-docbook.cat


docbook-dsssl (1.77)

* http://freshmeat.net/projects/docbook/
* http://www.geocities.com/tush/lfs

	cat docbook-dsssl.Makefile > Makefile
	if [ ! -z ${PREVIOUS} ]
	then
		install-catalog --remove /etc/sgml/dsssl-docbook-stylesheets.cat /usr/share/sgml/docbook/dsssl-stylesheets-${PREVIOUS}/catalog
		install-catalog --remove /etc/sgml/sgml-docbook.cat /etc/sgml/dsssl-docbook-stylesheets.cat
	fi
	make VERSION=${VERSION} install
	install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat /usr/share/sgml/docbook/dsssl-stylesheets-${VERSION}/catalog
	install-catalog --add /etc/sgml/sgml-docbook.cat /etc/sgml/dsssl-docbook-stylesheets.cat


docbook-utils (0.6.11)

* http://freshmeat.net/projects/docbook-utils/

	./configure --prefix=/usr --sysconfdir=/etc
	make
	make install


docbook-xsl (1.53.0)

* http://freshmeat.net/projects/docbook/

	install -d /usr/share/sgml/docbook/xsl-stylesheets-${VERSION}
	cp -af common extensions fo html htmlhelp images javahelp lib template xhtml /usr/share/sgml/docbook/xsl-stylesheets-${VERSION}
	if [ ! -f /etc/xml/catalog ]; then mkdir /etc/xml; xmlcatalog --noout --create /etc/xml/catalog; fi
	if [ ! -e /etc/xml/docbook ]; then xmlcatalog --noout --create /etc/xml/docbook; fi
	xmlcatalog --noout --add "rewriteSystem" "http://docbook.sourceforge.net/release/xsl/1.45" "/usr/share/sgml/docbook/xsl-stylesheets-${VERSION}" /etc/xml/catalog
	xmlcatalog --noout --add "rewriteURI" "http://docbook.sourceforge.net/release/xsl/1.45" "/usr/share/sgml/docbook/xsl-stylesheets-${VERSION}" /etc/xml/catalog
	xmlcatalog --noout --add "rewriteSystem" "http://docbook.sourceforge.net/release/xsl/current" "/usr/share/sgml/docbook/xsl-stylesheets-${VERSION}" /etc/xml/catalog
	xmlcatalog --noout --add "rewriteURI" "http://docbook.sourceforge.net/release/xsl/current" "/usr/share/sgml/docbook/xsl-stylesheets-${VERSION}" /etc/xml/catalog
	xmlcatalog --noout --add "delegateSystem" "http://docbook.sourceforge.net/release/xsl/" "file:///etc/xml/docbook" /etc/xml/catalog
	xmlcatalog --noout --add "delegateURI" "http://docbook.sourceforge.net/release/xsl/" "file:///etc/xml/docbook" /etc/xml/catalog


docbook-xml-dtd (4.1.2)

* http://www.oasis-open.org/docbook/xml/

	V=${VERSION/.}
	XML_DTD_DIR=/usr/share/xml/docbook/xml-dtd-${VERSION}
	ROOTCATALOG=/etc/xml/catalog
	CATALOG=/etc/xml/docbook
	install -d ${XML_DTD_DIR}
	cp -af docbook.cat *.dtd ent/ *.mod ${XML_DTD_DIR}
	if [ ! -e ${ROOTCATALOG} ]; then xmlcatalog --noout --create ${ROOTCATALOG}; fi
	if [ ! -e ${CATALOG} ]; then xmlcatalog --noout --create ${CATALOG}; fi
	xmlcatalog --noout --add "public" "-//OASIS//ELEMENTS DocBook XML Information Pool V${VERSION}//EN" "file://${XML_DTD_DIR}/dbpoolx.mod" $CATALOG
	xmlcatalog --noout --add "public" "-//OASIS//DTD DocBook XML V${VERSION}//EN" "file://${XML_DTD_DIR}/docbookx.dtd" $CATALOG
	xmlcatalog --noout --add "public" "-//OASIS//ENTITIES DocBook XML Character Entities V${VERSION}//EN" "file://${XML_DTD_DIR}/dbcentx.mod" $CATALOG
	xmlcatalog --noout --add "public" "-//OASIS//ENTITIES DocBook XML Notations V${VERSION}//EN" "file://${XML_DTD_DIR}/dbnotnx.mod" $CATALOG
	xmlcatalog --noout --add "public" "-//OASIS//ENTITIES DocBook XML Additional General Entities V${VERSION}//EN" "file://${XML_DTD_DIR}/dbgenent.mod" $CATALOG
	xmlcatalog --noout --add "public" "-//OASIS//ELEMENTS DocBook XML Document Hierarchy V${VERSION}//EN" "file://${XML_DTD_DIR}/dbhierx.mod" $CATALOG
	xmlcatalog --noout --add "public" "-//OASIS//DTD XML Exchange Table Model 19990315//EN" "file://${XML_DTD_DIR}/soextblx.dtd" $CATALOG
	xmlcatalog --noout --add "public" "-//OASIS//DTD DocBook XML CALS Table Model V${VERSION}//EN" "file://${XML_DTD_DIR}/calstblx.dtd" $CATALOG
	xmlcatalog --noout --add "rewriteSystem" "http://www.oasis-open.org/docbook/xml/${VERSION}" "file://${XML_DTD_DIR}" $CATALOG
	xmlcatalog --noout --add "rewriteURI" "http://www.oasis-open.org/docbook/xml/${VERSION}" "file://${XML_DTD_DIR}" $CATALOG
	xmlcatalog --noout --add "delegatePublic" "-//OASIS//ENTITIES DocBook XML" "file://$CATALOG" $ROOTCATALOG
	xmlcatalog --noout --add "delegatePublic" "-//OASIS//DTD DocBook XML" "file://$CATALOG" $ROOTCATALOG
	xmlcatalog --noout --add "delegateSystem" "http://www.oasis-open.org/docbook/" "file://$CATALOG" $ROOTCATALOG
	xmlcatalog --noout --add "delegateURI" "http://www.oasis-open.org/docbook/" "file://$CATALOG" $ROOTCATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Publishing//EN" "file://${XML_DTD_DIR}/ent/iso-pub.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Greek Letters//EN" "file://${XML_DTD_DIR}/ent/iso-grk1.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Box and Line Drawing//EN" "file://${XML_DTD_DIR}/ent/iso-box.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Greek Symbols//EN" "file://${XML_DTD_DIR}/ent/iso-grk3.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN" "file://${XML_DTD_DIR}/ent/iso-amsn.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN" "file://${XML_DTD_DIR}/ent/iso-num.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Alternative Greek Symbols//EN" "file://${XML_DTD_DIR}/ent/iso-grk4.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Diacritical Marks//EN" "file://${XML_DTD_DIR}/ent/iso-dia.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Monotoniko Greek//EN" "file://${XML_DTD_DIR}/ent/iso-grk2.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN" "file://${XML_DTD_DIR}/ent/iso-amsa.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN" "file://${XML_DTD_DIR}/ent/iso-amso.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Russian Cyrillic//EN" "file://${XML_DTD_DIR}/ent/iso-cyr1.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES General Technical//EN" "file://${XML_DTD_DIR}/ent/iso-tech.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN" "file://${XML_DTD_DIR}/ent/iso-amsc.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Added Latin 1//EN" "file://${XML_DTD_DIR}/ent/iso-lat1.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN" "file://${XML_DTD_DIR}/ent/iso-amsb.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Added Latin 2//EN" "file://${XML_DTD_DIR}/ent/iso-lat2.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN" "file://${XML_DTD_DIR}/ent/iso-amsr.ent" $CATALOG
	xmlcatalog --noout --add "public" "ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN" "file://${XML_DTD_DIR}/ent/iso-cyr2.ent" $CATALOG
	xmlcatalog --noout --add "delegatePublic" "ISO 8879:1986" "file://$CATALOG" $ROOTCATALOG


docbook-xml-simple-dtd (4.1.2.5)

* http://www.oasis-open.org/docbook/xml/simple/

	V=${VERSION/.}
	V=${V/.}
	V=${V/.}
	XML_DTD_DIR=/usr/share/xml/docbook/xml-simple-dtd-${VERSION}
	install -d ${XML_DTD_DIR}
	cp -af *.css *.dtd *.mod ${XML_DTD_DIR}


scrollkeeper (0.3.11)

* http://freshmeat.net/projects/scrollkeeper/

	./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var --disable-static --with-omfdirs=/usr/share/omf:/opt/gnome/share/omf:/opt/kde/share/omf
	make
	make install
	xmlcatalog --noout --add "public" "-//OMF//DTD Scrollkeeper OMF Variant V1.0//EN" "`echo "/usr/share/xml/scrollkeeper/dtds/scrollkeeper-omf.dtd" |sed -e "s://:/:g"`" /etc/xml/catalog


Siguiendo el método utilizado en esta receta, puedes descargar e instalar más 
catálogos cuando los encuentres apropiados para tus necesidades.

Revisa también las páginas de manual de xmlcatalog e install-catalog. En ellas se
indica cómo eliminar catálogos obsoletos (por ejemplo, si instalas una nueva versión
y necesitas eliminar la antigua).

No soy un experto en sgml y este documento está basado en mis descubrimientos
intentando instalar los prerrequisitos para GNOME-2. Por tanto puede haber errores,
si es así hazmelo saber.

No olvides mandarme informes de errores y mejoras para que pueda mantener la
receta actualizada. Un lugar apropiado para plantear problemas es la lista de
correo blfs-support.