BOOK/INSTALL

   1 Ok, so you have downloaded the XML source. Now what? You are probably
   2 wanting to convert these XML files to easier to read HTML, PS, PDF, TXT
   3 or other formatted files. All that can be read below.
   4
   5 Let's start by downloading some software.
   6
   7 If all you want to do is being able to convert XML to HTML download the
   8 following:
   9
  10 OpenJade                  - http://openjade.sourceforge.net/
  11 DocBook-XML DTD           - http://www.docbook.org/xml/4.1.2/
  12 Modified DocBook Entities -
  13         http://ftp.linuxfromscratch.org/misc/docbook-4.1.2-newent.tar.bz2
  14 DSSSL DocBook Stylesheets - http://www.nwalsh.com/docbook/dsssl/
  15
  16 As the DocBook DTD and Stylesheets are made available as a zip achives you
  17 may need to download the unzip package as well if your Linux system doesn't
  18 have one:
  19
  20 Unzip                     - ftp://ftp.uu.net/pub/archiving/zip/src/
  21
  22 If you want to be able to convert the book into PS and PDF as well I
  23 recommend using the Htmldoc program. This takes a html file (created
  24 with openjade which you already downloaded) and converts it to PS or
  25 PDF:
  26
  27 HTMLDOC                   - http://www.easysw.com/htmldoc/
  28 FLTK (X front-end)        - http://sourceforge.net/projects/fltk
  29
  30 If you want to be able to convert the book into TXT as well I recommend
  31 using lynx to convert HTML to TXT using the -dump option to lynx.
  32
  33 Lynx                                      - http://lynx.browser.org
  34
  35 You have everything you need now. Let's install this stuff.
  36
  37 Create the /usr/share/docbook directory, cd into it and unpack the
  38 docbook-xml dtd archive there. Move all the files and directories from
  39 the newly created subdirectory to the current directory
  40 (/usr/share/docbook). We don't really need a
  41 /usr/share/docbook/docbook-<version> subdir for our purposes.
  42
  43 Remove the ent directory and unpack the docbook-4.1.2-newent.tar.bz2 file.
  44 This will create a new ent directory with entity files that work better
  45 with XML.
  46
  47 Create the /usr/share/dsssl directory, cd into it and unpack the dsssl
  48 stylesheet archive in there. Rename the directory that's created by tar
  49 into 'docbook'. Now copy the lfs.dsl file you will find in
  50 the LFS-BOOK XML archive into /usr/share/dsssl/docbook/html
  51
  52 The last step is installing OpenJade.
  53
  54 In order for openjade to be able to convert the DocBook based documents
  55 into other formats, it needs to know where the DocBook DTD related
  56 files are located. This is sort of the DocBook equivalent for the $PATH
  57 variable. You have two ways of doing this:
  58
  59 1) You can set the $SGML_CATALOG_FILES variable and include the full
  60 paths to the catalog files in it
  61    or
  62 2) You can hard-code the paths into the openjade binary.
  63
  64 If you choose option 1, add the following to your bash configuration
  65 file, system wide profile or wherever you wish to include it:
  66
  67 export SGML_CATALOG_FILES=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog
  68
  69 Followed by installing openjade by running:
  70         ./configure --prefix=/usr
  71         make
  72         make install
  73         cp -av dsssl /usr/share/dsssl/openjade
  74
  75 If you choose option 2, install OpenJade as follows:
  76
  77         ./configure --prefix=/usr \
  78         > --enable-default-catalog=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog
  79         make
  80         make install
  81         cp -av dsssl /usr/share/dsssl/openjade
  82
  83 And you don't have to worry about the $SGML_CATALOG_FILES variable in
  84 this case.
  85
  86
  87 You're all set to convert XML to HTML (among a few other formats
  88 supported by openjade) now. If you want to convert to PS and PDF as
  89 well, install the following two packages.
  90
  91 FLTK (you can skip this one if you don't want the X front-end):
  92         ./configure --prefix=/usr
  93         make
  94         make install
  95
  96 HTMLDOC:
  97 Install by running:
  98
  99         ./configure --prefix=/usr
 100         make
 101         make install
 102
 103
 104
 105 The last package is Lynx which will be used for the HTML to TXT
 106 conversion. Install it by running:
 107
 108         ./configure --prefix=/usr
 109         make
 110         make install
 111
 112 There, all set now. Go back to the README file for some examples how to
 113 convert this XML to the various other formats.
 114