BOOK/INSTALL

   1 LFS Book Conversion Tools Installation Instructions
   2
   3 After downloading the CVS source, there are some things that need to be set up
   4 on your computer if you want to convert the XML source into something easier to
   5 read (e.g. HTML, TXT, PS or PDF).  If you are interested in this, then keep
   6 reading.  If you are only interested in editing the XML source for re-
   7 submission to the lfs-book or lfs-dev mailing lists, then you do not need this
   8 document.  Instead, you need to read the LFS Editor's Manual.  See the LFS
   9 website at http://www.linuxfromscratch.org for more information.
  10
  11 -------------------------------------------------------------------------------
  12 If all you want to do is convert XML to HTML perform the following:
  13
  14 First, let's handle some dependencies:
  15
  16 * Unzip
  17   - http://www.linuxfromscratch.org/blfs/view/cvs/general/unzip.html
  18
  19 * SGML Common
  20   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/sgml-common.html
  21
  22 * libxml2
  23   - http://www.linuxfromscratch.org/blfs/view/cvs/general/libxml2.html
  24
  25 Now install the following:
  26
  27 * DocBook DTD
  28   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/DocBook.html
  29
  30 * DSSSL DocBook Stylesheets
  31   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/docbook-dsssl.html
  32
  33 * OpenSP
  34   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/opensp.html
  35
  36 * OpenJade
  37   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/openjade.html
  38
  39 Once you have followed the installation instructions for all these packages
  40 from the BLFS Book, then you have a basic DocBook setup.  Below are some
  41 alternate packages that you can use to convert to other formats.
  42
  43 -------------------------------------------------------------------------------
  44 If you want to be able to convert the book into PS and PDF as well, then you
  45 will need the Htmldoc package. This takes a HTML file (created with openjade
  46 which you already installed) and converts it to PS or PDF:
  47
  48   - http://www.easysw.com/htmldoc/
  49
  50   Install HTMLDOC by running:
  51         ./configure --prefix=/usr
  52         make
  53         make install
  54
  55 An excellent X front-end for HTMLDOC is FLTK.  If you will be doing rendering
  56 in X, then you will probably want this package.
  57
  58   - http://sourceforge.net/projects/fltk
  59
  60   Install FLTK bt running:
  61         ./configure --prefix=/usr
  62         make
  63         make install
  64
  65 If you want to be able to convert the book into TXT as well, then you need the
  66 lynx browser.  Conversion is handled via the -dump option.
  67
  68   - http://www.linuxfromscratch.org/blfs/view/cvs/basicnet/lynx.html
  69
  70 You are finished installing everything.  Read the README file for some examples
  71 how to convert this XML to the various other formats.
  72