Installing Docbook SGML and XML Utils

Tushar Teredesai tush at yahoo.com
Tue Jul 9 00:38:37 PDT 2002


This is a multi-part message in MIME format.
--------------080907070508050009070006
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

As I had mentioned, the docbook installation instructions. Made it into 
a hint so that it will be available even if it is not put into the BLFS 
book.

-- 
Tushar Teredesai
LFS ID: 1377
http://www.geocities.com/tush/lfs/


--------------080907070508050009070006
Content-Type: text/plain;
 name="docbook.txt"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="docbook.txt"

TITLE:		Installing Docbook DTDs and Tools

LFS VERSION:	Any.

AUTHOR:		Tushar Teredesai <Tush at Yahoo.Com>

SYNOPSIS:
	How to install docbook tools and openjade.

HINT:

Change Log:
[2002-07-08]
	* First public version.

Pre-requisites (post LFS):
        * InfoZip Unzip <http://freshmeat.net/projects/unzip/>
	* LibXML <http://freshmeat.net/projects/libxml/>

Alternate site:
This hint is also available at <http://www.geocities.com/tush/lfs>. The latest
version of the hint is usually available there.


We will install scripts so that will allow centralized SGML and XML catalogs and
hence there won't be any need for setting the SGML_CATALOG_FILES variable. Most
of the installation scripts are straight forward (install package & then install
catalog). Hence I won't bore you with lot of details.


sgml-common (0.6.3):

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

	./configure --prefix=/usr
	make
	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-1.3.1
	make
	make install
	ln -s openjade /usr/bin/jade
	ln -s onsgmls /usr/bin/nsgmls
	ln -s ospam /usr/bin/spam
	ln -s ospent /usr/bin/spent
	ln -s osx /usr/bin/sgml2xml
	mkdir /usr/include/OpenSP
	cp generic/*.h /usr/include/OpenSP/
	cp include/*.h /usr/include/OpenSP/
	cp lib/*.h /usr/include/OpenSP/
	echo 'SYSTEM "builtins.dsl" "builtins.dsl"' > \
		/usr/share/sgml/openjade-1.3.1/catalog
	cp -af dsssl/ pubtext/ /usr/share/sgml/openjade-1.3.1
	echo "PUBLIC \"-//James Clark//DTD DSSSL Flow Object Tree//EN\" \
		\"fot.dtd\"" >> /usr/share/sgml/openjade-1.3.1/dsssl/catalog
	echo "PUBLIC \"ISO/IEC 10179:1996//DTD DSSSL Architecture//EN\" \
		\"dsssl.dtd\"" >> /usr/share/sgml/openjade-1.3.1/dsssl/catalog
	echo "PUBLIC \"-//James Clark//DTD DSSSL Style Sheet//EN\" \
		\"style-sheet.dtd\"" >> \
		/usr/share/sgml/openjade-1.3.1/dsssl/catalog
	echo "PUBLIC \"-//OpenJade//DTD DSSSL Style Sheet//EN\" \
		\"style-sheet.dtd\"" >> \
		/usr/share/sgml/openjade-1.3.1/dsssl/catalog
	install-catalog --add /etc/sgml/openjade-1.3.1.cat \
		/usr/share/sgml/openjade-1.3.1/catalog
	install-catalog --add /etc/sgml/openjade-1.3.1.cat \
		/usr/share/sgml/openjade-1.3.1/dsssl/catalog
	install-catalog --add /etc/sgml/sgml-docbook.cat \
		/etc/sgml/openjade-1.3.1.cat

docbook sgml dtd (3.1)

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

	patch -p0 -i docbook-dtd31-sgml-1.0.catalog.patch
	make -f docbook-dtd31-sgml-1.0.Makefile install
	install-catalog --add /etc/sgml/sgml-docbook-dtd31.cat \
		/usr/share/sgml/docbook/sgml-dtd-3.1/catalog
	install-catalog --add /etc/sgml/sgml-docbook-dtd31.cat \
		/etc/sgml/sgml-docbook.cat

docbook sgml dtd (4.1)

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

	patch -p0 -i docbook-dtd41-sgml-1.0.catalog.patch
	make -f docbook-dtd41-sgml-1.0.Makefile install
	install-catalog --add /etc/sgml/sgml-docbook-dtd41.cat \
		/usr/share/sgml/docbook/sgml-dtd-4.1/catalog
	install-catalog --add /etc/sgml/sgml-docbook-dtd41.cat \
		/etc/sgml/sgml-docbook.cat

docbook-dsssl (1.77)

* http://freshmeat.net/projects/docbook/
* ftp://ftp.kde.org/pub/kde/devel/docbook/SOURCES/

	make -k -f docbook-style-dsssl-1.64.Makefile \
		DESTDIR=/usr/share/sgml/docbook/dssl-stylesheets-1.76 install
	install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
		/usr/share/sgml/docbook/dsssl-stylesheets-1.76/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
	make
	make install

docbook-xsl (1.51.1)

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

	mkdir /usr/share/sgml/docbook/xsl-stylesheets-1.51.1
	cp -af common extensions fo html htmlhelp images javahelp lib \
		template xhtml /usr/share/sgml/docbook/xsl-stylesheets-1.51.1/
	mkdir /etc/xml
	xmlcatalog --noout --create /etc/xml/catalog
	xmlcatalog --noout --add "rewriteSystem" \
		"http://docbook.sourceforge.net/release/xsl/1.45" \
		"/usr/share/sgml/docbook/xsl-stylesheets-1.51.1" \
		/etc/xml/catalog
	xmlcatalog --noout --add "rewriteURI" \
		"http://docbook.sourceforge.net/release/xsl/1.45" \
		"/usr/share/sgml/docbook/xsl-stylesheets-1.51.1" \
		/etc/xml/catalog
	xmlcatalog --noout --add "rewriteSystem" \
		"http://docbook.sourceforge.net/release/xsl/current" \
		"/usr/share/sgml/docbook/xsl-stylesheets-1.51.1" \
		/etc/xml/catalog
	xmlcatalog --noout --add "rewriteURI" \
		"http://docbook.sourceforge.net/release/xsl/current" \
		"/usr/share/sgml/docbook/xsl-stylesheets-1.51.1" \
		/etc/xml/catalog


Following the approach mentioned in this hint, you can download and install more
catalogs as and when you find them appropriate for your needs.

I am not an expert on sgml and this document is based on my findings trying to
install the prerequsites for GNOME-2. Hence there may be errors; if so please
let me know.

Don't forget to send me bug reports and enhancements so that I can keep the hint
updated. An appropriate place to discuss problems is the blfs-support mailing
list.


--------------080907070508050009070006--

-- 
Unsubscribe: send email to listar at linuxfromscratch.org
and put 'unsubscribe hints' in the subject header of the message



More information about the hints mailing list