# HG changeset patch # User diego # Date 1067175806 0 # Node ID 669e67c3d6b3f9f969cb4a67064cc5aa5c7e9aaa # Parent c367751bd7cb67e7c98f9610ac48dedbb0ac71d9 Red Hat support added by Dominik, README updated. diff -r c367751bd7cb -r 669e67c3d6b3 DOCS/xml/README --- a/DOCS/xml/README Sun Oct 26 12:28:45 2003 +0000 +++ b/DOCS/xml/README Sun Oct 26 13:43:26 2003 +0000 @@ -10,12 +10,16 @@ * xmllint (part of libxml2) is used for validation. * xsltproc (part of libxslt1) is used for transforming XML files into HTML - files. Version 1.0.18 or later is recommended. + files. Version 1.0.18 or later is recommended. -Also it's possible to use the Saxon XSLT Processor. Russian translator -used it (version 6.4.4) for a while. If you have suitable JavaVM and a saxon.jar -installed somewhere, configure will try to detect them. If autodetection fails, -try to tweak DOCS/xml/configure to get it working and send us a patch :) +It's also possible to use the Saxon XSLT Processor. The Russian translator +used it (version 6.4.4) for a while. If you have a suitable JavaVM and a +saxon.jar installed somewhere, configure will try to detect them. If +autodetection fails, try to tweak DOCS/xml/configure to get it working and +send us a patch :) + +On Red Hat systems you need the following packages: +libxml2, libxslt, docbook-dtds, docbook-style-xsl @@ -25,7 +29,7 @@ 1) Download libxslt AND libxml2 packages from http://xmlsoft.org/XSLT/downloads.html - Installing them should be straightforward, executing the usual "./configure" + Installing them should be straightforward, execute the usual "./configure" and "make" then "make install" commands. @@ -59,27 +63,20 @@ Building the documentation ~~~~~~~~~~~~~~~~~~~~~~~~~~ -1) Before trying to build the documentation, run +Before trying to build the documentation, run - make test + make help - to see if everything is set up properly. If something goes wrong, - check the Configuration section of the toplevel Makefile and adjust - the variables. - - -2) Now simply run - - make all - - to build the documentation. +to see all available build targets and make your choice. If something goes +wrong, check the Configuration section of the toplevel Makefile and adjust +the variables. A few words about SGML catalog files ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ As far as I know, the document type declaration in XML files requires -both a public and a system identifier. For example: +both a public and a system identifier. For example: @@ -96,14 +93,10 @@ The problem is that the system identifier is most probably system-dependent. To avoid the need to manually fix the system identifiers before building the -documentation, I've decided to use SGML catalogs. If you have your catalogs +documentation, I've decided to use SGML catalogs. If you have your catalogs set up correctly, xmllint and xsltproc will use them to find the DTDs based on the public identifiers. Note that this works only if public identifiers override system identifiers -(i.e. the catalog file must contain 'OVERRIDE YES'). (I had no problem with +(i.e. the catalog file must contain 'OVERRIDE YES'). (I had no problem with these on my system, since the Debian people took care of everything. ;-)) - - --- -Andras Mohari diff -r c367751bd7cb -r 669e67c3d6b3 DOCS/xml/configure --- a/DOCS/xml/configure Sun Oct 26 12:28:45 2003 +0000 +++ b/DOCS/xml/configure Sun Oct 26 13:43:26 2003 +0000 @@ -6,7 +6,7 @@ _xsltwrapper="xsltproc.sh" _xmllintwrapper="xmllint.sh" -for _try_catalog in /etc/sgml/catalog /usr/share/sgml/docbook/xml-dtd-4.1.2/xmlcatalog /usr/share/apps/ksgmltools2/customization/en/catalog /usr/share/sgml/catalog /usr/local/share/sgml/catalog /usr/lib/sgml/catalog /usr/local/lib/sgml/catalog /usr/share/docbook-xml42/catalog.xml +for _try_catalog in /etc/sgml/catalog /usr/share/sgml/docbook/xml-dtd-4.1.2/xmlcatalog /usr/share/apps/ksgmltools2/customization/en/catalog /usr/share/sgml/catalog /usr/local/share/sgml/catalog /usr/lib/sgml/catalog /usr/local/lib/sgml/catalog /usr/share/docbook-xml42/catalog.xml /usr/share/sgml/docbook/xmlcatalog do if test -f "$_try_catalog" then @@ -27,7 +27,7 @@ echo "Searching for stylesheets..." echo "Searching for html/chunk.xsl..." -for _try_chunk_xsl in /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/chunk.xsl /usr/share/sgml/docbook/yelp/docbook/html/chunk.xsl /usr/local/share/sgml/docbook/stylesheet/xsl/nwalsh/html/chunk.xsl /usr/local/share/sgml/docbook/yelp/docbook/html/chunk.xsl /usr/share/docbook-xsl/html/chunk.xsl +for _try_chunk_xsl in /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/chunk.xsl /usr/share/sgml/docbook/yelp/docbook/html/chunk.xsl /usr/local/share/sgml/docbook/stylesheet/xsl/nwalsh/html/chunk.xsl /usr/local/share/sgml/docbook/yelp/docbook/html/chunk.xsl /usr/share/docbook-xsl/html/chunk.xsl /usr/share/sgml/docbook/xsl-stylesheets/html/chunk.xsl do if test -f "$_try_chunk_xsl" then @@ -46,7 +46,7 @@ fi echo "Searching for html/docbook.xsl..." -for _try_docbook_xsl in /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl /usr/share/sgml/docbook/yelp/docbook/html/docbook.xsl /usr/local/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl /usr/local/share/sgml/docbook/yelp/docbook/html/docbook.xsl /usr/share/docbook-xsl/html/docbook.xsl +for _try_docbook_xsl in /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl /usr/share/sgml/docbook/yelp/docbook/html/docbook.xsl /usr/local/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl /usr/local/share/sgml/docbook/yelp/docbook/html/docbook.xsl /usr/share/docbook-xsl/html/docbook.xsl /usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xsl do if test -f "$_try_docbook_xsl" then