Changeset e858efa

Timestamp:

12/10/2004 07:41:21 PM (20 years ago)

Author:

Matthew Burgess <matthew@…>

Children:

2bdf98e

Parents:

10de47b

Message:

Updated INSTALL instructions for latest Docbook-XSL package

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/testing/BOOK@4375 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:

• INSTALL (modified) (2 diffs)

INSTALL

@@ -1 +1 @@
 LFS Book Conversion Tools Installation Instructions
 
-After downloading the CVS source, there are some things that need to be set up 
+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 
@@ -21 +21 @@
   - http://www.linuxfromscratch.org/blfs/view/svn/pst/xml.html
 
-* DocBook XSL Stylesheets
-  - http://www.linuxfromscratch.org/blfs/view/svn/pst/docbook-xsl.html
-  - additionally create a link from
-    /usr/share/xml/docbook/xsl-stylesheets-1.65.1 to
+* DocBook XSL Stylesheets (1.67.2)
+  install -d /usr/share/xml/docbook/xsl-stylesheets-1.67.2
+  chown -R root:root .
+  cp -af INSTALL VERSION common eclipse extensions fo html htmlhelp images \
+    javahelp lib manpages params profiling template xhtml \
+    /usr/share/xml/docbook/xsl-stylesheets-1.67.2
+  install -d /usr/share/doc/xml
+  cp -af doc/* /usr/share/doc/xml
+  cd /usr/share/xml/docbook/xsl-stylesheets-1.67.2 && \
+    sed -i -e 's@current/@1.67.2/@' INSTALL && \
+    sh INSTALL
+  xmlcatalog --noout --add "delegateURI" \
+  "http://docbook.sourceforge.net/release/xsl/1.67.2/" \
+  "file:///usr/share/xml/docbook/xsl-stylesheets-1.67.2/catalog.xml" \
+  /etc/xml/catalog
+  ln -sf xsl-stylesheets-$(VERSION) \
     /usr/share/xml/docbook/xsl-stylesheets-current
-
-    cd /usr/share/xml/docbook/ &&
-    ln -s xsl-stylesheets-1.65.1 xsl-stylesheets-current
 
 * HTMLTidy
   - http://www.linuxfromscratch.org/blfs/view/svn/general/tidy.html
-  Patch to fix an issue with <pre> tags when the pages are served
-  like application/xhtml+xml (not needed to see the pages locally)
-  - http://www.macana-es.com/tidy-041005-fix-pre-tags-for-xhtml-1.patch
+  - you'll also need the patch at http://linuxfromscratch.org/~matthew/tidy-041026-prevent_PRE_newlines-1.patch as well.
 
 ------------------------------------------------------------------------------- 
 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:
+already installed) and converts it to PDF.  FOP is dependent on ANT
+(Another Neat Tool) and the Java Advanced Imaging (JAI) API.
 
-  - http://www.apache.org/dist/xml/fop/fop-0.20.5-bin.tar.gz
+First we need the Java SDK installed.  See
+http://www.linuxfromscratch.org/blfs/view/svn/general/j2sdk.html.
 
-  Install FOP by running:
+Now install JAI:
+  - Download jai-1_1_2_01-lib-linux-i586-jdk.bin from
+    http://java.sun.com/products/java-media/jai/downloads/download-1_1_2_01.html
+(download the version for the JDK Install).
+  - chmod +x jai-1_1_2_01-lib-linux-i586-jdk.bin
+  - cd /opt/j2sdk && /path/to/jai-1_1_2_01-lib-linux-i586-jdk.bin
 
-  cd /opt &&
-  tar -xzvf /usr/src/fop-0.20.5-bin.tar.gz &&
-  mv fop-0.20.5 fop
+Next install ANT:
+  - download http://www.apache.org/dist/ant/source/apache-ant-1.6.2-src.tar.bz2
+  - tar -xjvf apache-ant-1.6.2-src.tar.bz2
+    (recent versions of tar will warn about "A lone zero block at 33476" but
+    this can be safely ignored)
+  - cd apache-ant-1.6.2 && \
+    ./boostrap.sh && \
+    ./build && \
+    install -d /opt/ant && \
+    cp -r dist/* /opt/ant
+  - edit your bash profile to set ANT_HOME=/opt/ant and PATH=$PATH:/opt/ant/bin
 
-  Now set JAVA_HOME, FOP_HOME and PATH to values appropriate to your system.
+And finally install FOP:
+  - download http://www.apache.org/dist/xml/fop/fop-0.20.5-src.tar.gz
+  - tar -xzvf fop-0.20.5-src.tar.gz
+    (recent versions of tar will warn about "A lone zero block at 33476" but
+    this can be safely ignored)
+  - cd fop-0.20.5 &&
+    ./build.sh &&
+    install -d /opt/fop/{bin,lib} &&
+    cp lib/{avalon-framework-cvs-20020806.jar,batik.jar} build/fop.jar \
+    /opt/fop/lib &&
+    cp fop.sh /opt/fop/bin
+  - edit your bash profile to set FOP_HOME=/opt/fop and PATH=$PATH:/opt/fop/bin