cvs commit: hints docbook.txt

timothy at linuxfromscratch.org timothy at linuxfromscratch.org
Tue Jul 9 09:38:47 PDT 2002


timothy     02/07/09 09:38:47

  Added:       .        docbook.txt
  Log:
  Initial commit.
  
  Revision  Changes    Path
  1.1                  hints/docbook.txt
  
  Index: 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.
  
  
  
-- 
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