Setting up the tools was the hard the first time. The maze of catalogs, programs and acronyms is daunting to the first time (even technically minded) user. I couldn't tell what I needed. Never mind the miles of error message these tools generate by default. But this method is quick and painless
First setup some handy environmental variables.
export DBARCHIVE=/where/you/put/your/downloads
export SGMLHOME=/where/you/want/to/install/everything
|
The only package that requires compiling is openjade. Openjade is a reasonable GNU autotools source build. Be sure to add openjade's lib directory to your library search path ($LD_LIBRARY_PATH or ld.so.conf on Linux). Also be sure to add openjade's bin directory to your PATH. Note that you have to manually copy the dsssl subdirectory as openjade's install doesn't do it for you.
cd /where/you/compile/source
tar -xzf $DBARCHIVE/openjade-1.3.1.tar.gz
cd openjade-1.3.1
./configure --prefix=$SGMLHOME/openjade-1.3 --enable-http && make && make install
cp -a dsssl $SGMLHOME/openjade-1.3.1
|
Next, you'll need to unpack all the DocTools DTDs and entities. The entities should be renamed to end in '.gml' . You can rename them by hand or try my one line bash script.
cd $SGMLHOME
mkdir dtd
cd dtd
unzip -a $DBARCHIVE/docbook-sgml-4.2.zip
unzip -a $DBARCHIVE/ISOEnts.zip
for i in ISO*;do mv $i `echo $i | sed -e 's/ISO/iso-/g'`.gml;done
|
Now, we're ready to unpack Norm Walsh's and the LDP's Styles Sheets.
cd $SGMLHOME
tar -xzf $DBARCHIVE/docbook-dsssl-1.77.tar.gz
mv docbook-dsssl-1.77 dsssl
cd dsssl
cp $DBARCHIVE/ldp.dsl html/
cp $DBARCHIVE/ldp.dsl print/
|
Finally, we need to setup our SGML_CATALOG_FILES evironment variable. This variable is a colon seperated list of files that openjade will use to find 'stuff'. Once you get it set and working, I recommend making this a permanent fixture in your environment (.bash_profile,.profile, etc.).
export SGML_CATALOG_FILES=$SGMLHOME/openjade-1.3.1/dsssl/catalog:$SGMLHOME/dtd/docbook.cat
|