|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
Packit |
e4b6da |
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
Packit |
e4b6da |
<head>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"text/html; charset=us-ascii" />
|
|
Packit |
e4b6da |
<title>docbook2X: Dependencies on other software</title>
|
|
Packit |
e4b6da |
<link rel="stylesheet" href="docbook2X.css" type="text/css" />
|
|
Packit |
e4b6da |
<link rev="made" href="mailto:stevecheng@users.sourceforge.net" />
|
|
Packit |
e4b6da |
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"Other software packages that docbook2X needs" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"docbook2X: Documentation Table of Contents" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"docbook2X: Package installation" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"docbook2X: Package installation" />
|
|
Packit |
e4b6da |
<link rel="next" href="cindex.html" title="docbook2X: Index" />
|
|
Packit |
e4b6da |
</head>
|
|
Packit |
e4b6da |
<body>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
Dependencies on other software
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"install.html"><< Previous
|
|
Packit |
e4b6da |
Package installation
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"cindex.html">Next >>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"dependencies">Dependencies on other software
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"id2547485" class="indexterm" name="id2547485">
|
|
Packit |
e4b6da |
"id2547492" class="indexterm" name="id2547492">
|
|
Packit |
e4b6da |
To use docbook2X you need:
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
A reasonable Unix system, with Perl
|
|
Packit |
e4b6da |
5
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
docbook2X can work on Linux, FreeBSD, Solaris, and Cygwin on
|
|
Packit |
e4b6da |
Windows.
|
|
Packit |
e4b6da |
A C compiler is required to compile a small ANSI C program
|
|
Packit |
e4b6da |
(utf8trans).
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
XML-NamespaceSupport, XML-SAX, XML-Parser
|
|
Packit |
e4b6da |
and XML-SAX-Expat (Perl modules)
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
The
|
|
Packit |
e4b6da |
last two are optional: they add a Perl interface to the C-based XML
|
|
Packit |
e4b6da |
parser Expat. It is recommended that you install them anyway;
|
|
Packit |
e4b6da |
otherwise, the fallback Perl-based XML parser makes docbook2X real
|
|
Packit |
e4b6da |
slow.
|
|
Packit |
e4b6da |
You can get all the Perl modules here:
|
|
Packit |
e4b6da |
"http://www.cpan.org/modules/by-category/11_String_Lang_Text_Proc/XML/"
|
|
Packit |
e4b6da |
target="_top">CPAN XML module listing.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
iconv
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
If you are running Linux glibc, you already have it. Otherwise,
|
|
Packit |
e4b6da |
see
|
|
Packit |
e4b6da |
"_top">the GNU libiconv home page.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
XSLT 1.0 processor
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"id2547623" class="indexterm" name="id2547623">
|
|
Packit |
e4b6da |
"id2547630" class="indexterm" name="id2547630"> You have a
|
|
Packit |
e4b6da |
choice of:
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
libxslt
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
See the libxml2,
|
|
Packit |
e4b6da |
libxslt home page.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
SAXON
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
See the
|
|
Packit |
e4b6da |
SAXON home page.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
Xalan-Java
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
See the
|
|
Packit |
e4b6da |
Xalan-Java home page.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
For
|
|
Packit |
e4b6da |
the Java-based processors (SAXON and Xalan-Java), you will also
|
|
Packit |
e4b6da |
need<sup>[
|
|
Packit |
e4b6da |
"id2547719">6]</sup>
|
|
Packit |
e4b6da |
target="_top">the Apache XML Commons distribution. This adds
|
|
Packit |
e4b6da |
XML catalogs support to any Java-based processor.
|
|
Packit |
e4b6da |
Out of the three processors, libxslt is recommended. (I would
|
|
Packit |
e4b6da |
have added support for other XSLT processors, but only these three
|
|
Packit |
e4b6da |
seem to have proper XML catalogs support.)
|
|
Packit |
e4b6da |
Unlike previous versions of docbook2X, these Java-based
|
|
Packit |
e4b6da |
processors can work almost out-of-the-box. Also docbook2X no longer
|
|
Packit |
e4b6da |
needs to compile XSLT extensions, so you if you use an OS
|
|
Packit |
e4b6da |
distribution package of libxslt, you do not need the development
|
|
Packit |
e4b6da |
versions of the library any more.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
DocBook XML DTD
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
Make sure you set up the XML catalogs for the DTDs you
|
|
Packit |
e4b6da |
install.
|
|
Packit |
e4b6da |
The
|
|
Packit |
e4b6da |
"citetitle">DocBook: The Definitive Guide website has more
|
|
Packit |
e4b6da |
information.
|
|
Packit |
e4b6da |
You may also need the SGML DTD if your documents are SGML rather
|
|
Packit |
e4b6da |
than XML.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
Norman Walsh’s DocBook XSL
|
|
Packit |
e4b6da |
stylesheets
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
See the
|
|
Packit |
e4b6da |
"_top">Open DocBook Repository.
|
|
Packit |
e4b6da |
This is optional and is only used to build documentation in HTML
|
|
Packit |
e4b6da |
format. In your XML catalog, point the URI in
|
|
Packit |
e4b6da |
"filename">doc/ss-html.xsl to a local copy of the
|
|
Packit |
e4b6da |
stylesheets.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
For all the items above, it will be easier for you to install
|
|
Packit |
e4b6da |
the OS packaging of the software (e.g. Debian packages), than to
|
|
Packit |
e4b6da |
install them manually. But be aware that sometimes the OS package
|
|
Packit |
e4b6da |
may not be for an up-to-date version of the software.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
If you cannot satisfy all the prerequisites above (say you are
|
|
Packit |
e4b6da |
on a vanilla Win32 system), then you will not be able to
|
|
Packit |
e4b6da |
“build” docbook2X properly, but if you are
|
|
Packit |
e4b6da |
knowledgeable, you can still salvage its parts (e.g. the XSLT
|
|
Packit |
e4b6da |
stylesheets, which can be run alone).
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<sup>[
|
|
Packit |
e4b6da |
"ftn.id2547719">6]</sup> Strictly speaking this component is
|
|
Packit |
e4b6da |
not required, but if you do not have it, you will almost certainly
|
|
Packit |
e4b6da |
have your computer downloading large XML files from the Internet
|
|
Packit |
e4b6da |
all the time, as portable XML files will not refer directly to
|
|
Packit |
e4b6da |
cached local copies of the required files.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"install.html"><< Previous
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"install.html">Up
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"cindex.html">Next >>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
Package
|
|
Packit |
e4b6da |
installation
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"docbook2X.html">Table of Contents
|
|
Packit |
e4b6da |
Index
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
"http://docbook2x.sourceforge.net/" title=
|
|
Packit |
e4b6da |
"docbook2X: Home page">docbook2X home page
|
|
Packit |
e4b6da |
</body>
|
|
Packit |
e4b6da |
</html>
|