Commits

Dongsheng Song  committed 3d6f290

Update README.BUILD

  • Participants
  • Parent commits 851bed1

Comments (0)

Files changed (2)

File Makefile.vars.tmpl

 #
-# Please create your Makefile.vars file from this template file.
+# Please create your Makefile.vars from this template file.
 #
 # Please use absolute path, DO NOT use relative path !
 #
 
-# po4a (>= 0.36.1): Only for PO based Makefile !
+# po4a (>= 0.36.1): Only for PO based translation !
 # po4A_HOME=/usr/bin
 # PO4A_LIB=/usr/share/perl5
-PO4A_HOME=/home/dongsheng/var/svn/i18n-zh/trunk/lib/po4a
+PO4A_HOME=/home/dongsheng/vcs/svn/i18n-zh/trunk/lib/po4a
 PO4A_LIB=$(PO4A_HOME)/lib
 
 # saxon65.jar, saxon65-dbxsl.jar, xml-commons-resolver-1.2.jar: Only for pdf format !
-JAVA_LIB=/home/dongsheng/var/svn/i18n-zh/trunk/lib/share/java
+JAVA_LIB=/home/dongsheng/vcs/svn/i18n-zh/trunk/lib/share/java
 
 # fop (>= 0.9.6): Only for pdf format !
-FOP_HOME=/home/dongsheng/var/svn/i18n-zh/trunk/lib/fop
+FOP_HOME=/home/dongsheng/vcs/svn/i18n-zh/trunk/lib/fop
 
 # docbook-xsl (>= 1.74.3): Only for ePub format !
-DB2EPUB=/home/dongsheng/var/svn/i18n-zh/trunk/lib/docbook/docbook-xsl/epub/bin/dbtoepub
+DB2EPUB=/home/dongsheng/vcs/svn/i18n-zh/trunk/lib/docbook/docbook-xsl/epub/bin/dbtoepub

File README.BUILD

   The Makefile will actually invoke $FOP_HOME/fop.sh, you should do
   some trick, let fop's CLASSPATH include saxon.jar and docbook-xsl-saxon.jar .
 
-5. Make
+5. Configure XML Catalogs
+  For non pdf output, we use xsltproc for XSLT process, which use system
+  catalog files automatically, usually /etc/xml/catalog. Users do not need to
+  care about it.
+
+  For pdf output, we need use the xsl extensions (docbook-xsl-saxon), so we must
+  create file $JAVA_LIB/CatalogManager.properties like this:
+
+      catalogs=/etc/xml/catalog
+      relative-catalogs=true
+      static-catalog=yes
+      catalog-class-name=org.apache.xml.resolver.Resolver
+      verbosity=1
+
+6. Create Makefile.vars
+  Please create your Makefile.vars from Makefile.vars.tmpl .
+
+7. Make
   Run 'make' for more details, for example:
 
   * make all document(pdf, html and html-single for all languages)