source: INSTALL@ 30ae6314

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/
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.info-zip.org/pub/infozip/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. There
are most likely better programs to do this, but Lynx is often installed
on systems anyways (as a console based web browser). Another often used
console based browser is Links which can be used in the same way as
Lynx.

Lynx                      - http://lynx.browser.org
Links                     - http://artax.karlin.mff.cuni.cz/~mikulas/links/

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.

Create the /usr/share/dsssl directory, cd into it and unpack the dsssl
stylesheet archive in there. Now copy the lfs.dsl file you will find in
the LFS-BOOK XML archive into /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:
Edit the Makefile.in file and find these lines:

install:
    $(MAKE) all
    for dir in $(INSTALLDIRS); do\
        echo Installing in $$dir...;\
        (cd $$dir; $(MAKE) -$(MAKEFLAGS) clean) || break;\
    done

Change this into:

install:
    $(MAKE) all
    for dir in $(INSTALLDIRS); do\
        echo Installing in $$dir...;\
        (cd $$dir; $(MAKE) -$(MAKEFLAGS) install) || break;\
    done

This will fix that little bug that causes 'make install' to be
identical to 'make clean'. Now continue with:

        ./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.