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 install the following:
  13
  14 * libxml2
  15   - http://www.linuxfromscratch.org/blfs/view/cvs/general/libxml2.html
  16
  17 * libxslt
  18   - http://www.linuxfromscratch.org/blfs/view/cvs/general/libxslt.html
  19
  20 * DocBook DTD
  21   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/xml.html
  22
  23 * DocBook XSL Stylesheets
  24   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/docbook-xsl.html
  25
  26 * HTML Tidy - http://tidy.sourceforge.net/src/tidy_src.tgz
  27
  28   /bin/sh build/gnuauto/setup.sh &&
  29   ./configure --prefix=/usr &&
  30   make &&
  31   su -c "make install"
  32
  33 -------------------------------------------------------------------------------
  34 If you want to be able to convert the book into PDF as well, then you will need
  35 the FOP package.  This takes an XSL-FO file (created with libxslt which you
  36 already installed) and converts it to PDF.  Additionally you will need
  37 the Java Advanced Imaging (JAI) library from
  38 http://java.sun.com/products/java-media/jai/downloads/download-1_1_2.html
  39 (you'll need either the JDK .bin or JRE .bin file dependent on your
  40 particular Java setup).
  41
  42   - http://www.apache.org/dist/xml/fop/fop-0.20.5-bin.tar.gz
  43
  44   Install FOP by running:
  45
  46   cd /opt &&
  47   tar -xzvf /usr/src/fop-0.20.5-bin.tar.gz &&
  48   mv fop-0.20.5 fop
  49
  50   Install JAI by running:
  51
  52   chmod u+x /path/to/jai-1_1_2-lib-linux-i586-jdk.bin &&
  53   cd $JAVA_HOME &&
  54   /path/to/jai-1_1_2-lib-linux-i586-jdk.bin
  55
  56   Now set JAVA_HOME, FOP_HOME and PATH to values appropriate to your system.