aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--INSTALL27
-rw-r--r--README18
2 files changed, 29 insertions, 16 deletions
diff --git a/INSTALL b/INSTALL
index 0dc22640d..0f6cc92a5 100644
--- a/INSTALL
+++ b/INSTALL
@@ -2,14 +2,15 @@ LFS Book Conversion Tools Installation Instructions
After downloading the SVN 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
+read (e.g. HTML, TXT, 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://www.linuxfromscratch.org for more information.
-------------------------------------------------------------------------------
-If all you want to do is convert XML to HTML perform the following:
+
+If you want to convert the XML to HTML, install the following:
* libxml2
- http://www.linuxfromscratch.org/blfs/view/svn/general/libxml2.html
@@ -27,15 +28,19 @@ If all you want to do is convert XML to HTML perform the following:
- http://www.linuxfromscratch.org/blfs/view/svn/general/tidy.html
-------------------------------------------------------------------------------
-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. FOP is dependant on the Java
-Advanced Imaging (JAI) API to render SVG graphics. Instructions to install the
-JAI are included in the FOP instructions. Perform the following:
-* J2SDK
- - http://www.linuxfromscratch.org/blfs/view/svn/general/j2sdk.html
+If you want to convert the XML to TXT, install the above items, and then install
+the following:
-* FOP
- - http://www.linuxfromscratch.org/blfs/view/svn/pst/fop.html
+* lynx
+ - http://www.linuxfromscratch.org/blfs/view/svn/basicnet/lynx.html
+
+-------------------------------------------------------------------------------
+If you want to convert the XML to PDF, install the following:
+
+* JDK
+ - http://www.linuxfromscratch.org/blfs/view/svn/general/jdk.html
+
+* FOP and JAI
+ - http://www.linuxfromscratch.org/blfs/view/svn/pst/fop.html
diff --git a/README b/README
index 61f7721a2..bcdb34182 100644
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-LFS Book Readme
+LFS Book README
This document is meant to instruct the user on how to convert the book's XML
source to other formats (e.g. HTML, PDF, PS and TXT). First, if you have not
@@ -9,12 +9,20 @@ various other formats.
XML to XHTML:
-------------
-
make BASEDIR=/path/to/output/location
+XML to single file XHTML (nochunks):
+------------------------------------
+make BASEDIR=/path/to/output/location nochunks
+
+
+XML to TXT
+----------
+Follow the instructions for nochunks and then run:
+lynx -dump /path/to/nochunks >/path/to/output
+
+
XML to PDF:
-----------
-
-make pdf &&
-cp lfs.pdf /path/to/output/location
+make BASEDIR=/path/to/output/location pdf