Subversion Repositories svn LFS-FR

Compare Revisions

Ignore whitespace Rev 473 → Rev 474

/trunk/lfs/INSTALL
1,72 → 1,56
LFS Book Conversion Tools Installation Instructions
 
After downloading the CVS source, there are some things that need to be setup
After downloading the CVS source, there are some things that need to be set up
on your computer if you want to convert the XML source into something easier to
read (e.g. HTML, TXT, PS or PDF). If you are interested in this, then keep
reading. If you are only interested in editing the XML source for re-
submission to the lfs-book or lfs-dev mailing lists, then you do not need this
document. Instead, you need to read the LFS Editor's Manual. See the LFS
website at http://linuxfromscratch.org for more information.
website at http://www.linuxfromscratch.org for more information.
 
-------------------------------------------------------------------------------
If all you want to do is convert XML to HTML perform the following:
If all you want to do is convert XML to HTML install the following:
 
First, let's handle some dependancies:
 
* Unzip
- http://www.linuxfromscratch.org/blfs/view/cvs/general/unzip.html
 
* SGML Common
- http://www.linuxfromscratch.org/blfs/view/cvs/pst/sgml-common.html
 
* libxml2
- http://www.linuxfromscratch.org/blfs/view/cvs/general/libxml2.html
 
Now install the following:
* libxslt
- http://www.linuxfromscratch.org/blfs/view/cvs/general/libxslt.html
 
* DocBook DTD
- http://www.linuxfromscratch.org/blfs/view/cvs/pst/DocBook.html
* DSSSL DocBook Stylesheets
- http://www.linuxfromscratch.org/blfs/view/cvs/pst/docbook-dsssl.html
- http://www.linuxfromscratch.org/blfs/view/cvs/pst/xml.html
 
* OpenSP
- http://www.linuxfromscratch.org/blfs/view/cvs/pst/opensp.html
* DocBook XSL Stylesheets
- http://www.linuxfromscratch.org/blfs/view/cvs/pst/docbook-xsl.html
 
* OpenJade
- http://www.linuxfromscratch.org/blfs/view/cvs/pst/openjade.html
* HTML Tidy - http://tidy.sourceforge.net/src/tidy_src.tgz
 
Once you have followed the installation instructions for all these packages
from the BLFS Book, then you have a basic DocBook setup. Below are some
alternate packages that you can use to convert to other formats.
/bin/sh build/gnuauto/setup.sh &&
./configure --prefix=/usr &&
make &&
su -c "make install"
 
-------------------------------------------------------------------------------
If you want to be able to convert the book into PS and PDF as well, then you
will need the Htmldoc package. This takes a HTML file (created with openjade
which you already installed) and converts it to PS or PDF:
If you want to be able to convert the book into PDF as well, then you will need
the FOP package. This takes an XSL-FO file (created with libxslt which you
already installed) and converts it to PDF. Additionally you will need
the Java Advanced Imaging (JAI) library from
http://java.sun.com/products/java-media/jai/downloads/download-1_1_2.html
(you'll need either the JDK .bin or JRE .bin file dependent on your
particular Java setup).
 
- http://www.easysw.com/htmldoc/
Install HTMLDOC by running:
./configure --prefix=/usr
make
make install
- http://www.apache.org/dist/xml/fop/fop-0.20.5-bin.tar.gz
 
An excellent X front-end for HTMLDOC is FLTK. If you will be doing rendering
in X, then you will probably want this package.
Install FOP by running:
 
- http://sourceforge.net/projects/fltk
cd /opt &&
tar -xzvf /usr/src/fop-0.20.5-bin.tar.gz &&
mv fop-0.20.5 fop
 
Install FLTK bt running:
./configure --prefix=/usr
make
make install
Install JAI by running:
 
If you want to be able to convert the book into TXT as well, then you need the
lynx browser. Conversion is handled via the -dump option.
chmod u+x /path/to/jai-1_1_2-lib-linux-i586-jdk.bin &&
cd $JAVA_HOME &&
/path/to/jai-1_1_2-lib-linux-i586-jdk.bin
 
- http://www.linuxfromscratch.org/blfs/view/cvs/basicnet/lynx.html
 
You are finished installing everything. Read the README file for some examples
how to convert this XML to the various other formats.
 
Now set JAVA_HOME, FOP_HOME and PATH to values appropriate to your system.