THIS IS OUT OF DATE. UPDATE PENDING. Ok, so you have downloaded the XML source. Now what? You are probably wanting to convert these XML files to easier to read HTML, PS, PDF, TXT or other formatted files. All that can be read below. Let's start by downloading some software. If all you want to do is being able to convert XML to HTML download the following: OpenJade - http://openjade.sourceforge.net/ DocBook-XML DTD - http://www.docbook.org/xml/4.1.2/ Modified DocBook Entities - http://linuxfromscratch.org/~gerard/docbook-4.1.2-newent.tar.bz2 DSSSL DocBook Stylesheets - http://www.nwalsh.com/docbook/dsssl/ As the DocBook DTD and Stylesheets are made available as a zip achives you may need to download the unzip package as well if your Linux system doesn't have one: Unzip - ftp://ftp.uu.net/pub/archiving/zip/src/ If you want to be able to convert the book into PS and PDF as well I recommend using the Htmldoc program. This takes a html file (created with openjade which you already downloaded) and converts it to PS or PDF: HTMLDOC - http://www.easysw.com/htmldoc/ FLTK (X front-end) - http://sourceforge.net/projects/fltk If you want to be able to convert the book into TXT as well I recommend using lynx to convert HTML to TXT using the -dump option to lynx. Lynx - http://lynx.browser.org You have everything you need now. Let's install this stuff. Create the /usr/share/docbook directory, cd into it and unpack the docbook-xml dtd archive there. Move all the files and directories from the newly created subdirectory to the current directory (/usr/share/docbook). We don't really need a /usr/share/docbook/docbook- subdir for our purposes. Remove the ent directory and unpack the docbook-4.1.2-newent.tar.bz2 file. This will create a new ent directory with entity files that work better with XML. Create the /usr/share/dsssl directory, cd into it and unpack the dsssl stylesheet archive in there. Rename the directory that's created by tar into 'docbook'. Now create a symlink to the blfs.dsl file you will find in the BLFS-BOOK XML archive in /usr/share/dsssl/docbook/html The last step is installing OpenJade. In order for openjade to be able to convert the DocBook based documents into other formats, it needs to know where the DocBook DTD related files are located. This is sort of the DocBook equivalent for the $PATH variable. You have two ways of doing this: 1) You can set the $SGML_CATALOG_FILES variable and include the full paths to the catalog files in it or 2) You can hard-code the paths into the openjade binary. If you choose option 1, add the following to your bash configuration file, system wide profile or wherever you wish to include it: export SGML_CATALOG_FILES=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog Followed by installing openjade by running: ./configure --prefix=/usr make make install cp -av dsssl /usr/share/dsssl/openjade If you choose option 2, install OpenJade as follows: ./configure --prefix=/usr \ --enable-default-catalog=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog make make install cp -av dsssl /usr/share/dsssl/openjade And you don't have to worry about the $SGML_CATALOG_FILES variable in this case. You're all set to convert XML to HTML (among a few other formats supported by openjade) now. If you want to convert to PS and PDF as well, install the following two packages. FLTK (you can skip this one if you don't want the X front-end): ./configure --prefix=/usr make make install HTMLDOC: Install by running: ./configure --prefix=/usr make make install The last package is Lynx which will be used for the HTML to TXT conversion. Install it by running: ./configure --prefix=/usr make make install There, all set now. Go back to the README file for some examples how to convert this XML to the various other formats.