~ubuntu-branches/ubuntu/quantal/dblatex/quantal

« back to all changes in this revision

Viewing changes to docs/xhtml/manual/sec-install-unix.html

  • Committer: Package Import Robot
  • Author(s): Andreas Hoenen
  • Date: 2012-06-07 15:25:28 UTC
  • mfrom: (0.13.1) (0.11.2) (8.1.10 sid)
  • Revision ID: package-import@ubuntu.com-20120607152528-1giqohxs5qmysb7e
Tags: 0.3.4-1
* New upstream release
  Closes: #675741
* 20_regression_simple_style.patch:
  Fix a regression that breaks simple style.
* 20_regression_zh-cn.patch:
  Fix a regression that breaks some documents with language zh-cn.
* 20_texlive_version_2009.patch:
  Keep the value 2009 for parameter texlive.version, as bigger values result
  in problems.
* Drop patches that have been integrated upstream:
  + 20_dblatex_sys_path.patch
  + 20_debian_errorhandler.patch
  + 20_glossary.patch
  + 20_missed_chars.patch
* debian/rules:
  Use new upstream install layout "deb", which enables us to simplify the
  rules file considerably.
* Remove python-4suite-xml dependency (alternative to xlstproc) as package has
  been removed from unstable (#637334) and as using it as XSLT processor has
  started to run into "out of memory" recently.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
 
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Installing on Unix like Systems</title><link rel="stylesheet" href="manual.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="DocBook to LaTeX Publishing" /><link rel="up" href="sec-install.html" title="Chapter 2. Installing the Package" /><link rel="prev" href="sec-install.html" title="Chapter 2. Installing the Package" /><link rel="next" href="ch02s03.html" title="Installing on Windows" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Installing on Unix like Systems</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sec-install.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing the Package</th><td width="20%" align="right"> <a accesskey="n" href="ch02s03.html">Next</a></td></tr></table><hr /></div><div class="section" title="Installing on Unix like Systems"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-install-unix"></a>Installing on Unix like Systems</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="sec-install-unix.html#id3615178">Dblatex Packages</a></span></dt><dt><span class="section"><a href="sec-install-unix.html#id3617692">Dependencies</a></span></dt><dt><span class="section"><a href="sec-install-unix.html#id3618089">Installation</a></span></dt></dl></div><div class="section" title="Dblatex Packages"><div class="titlepage"><div><div><h3 class="title"><a id="id3615178"></a>Dblatex Packages</h3></div></div></div><p>Dblatex is packaged for these Systems or Distributions:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><a class="ulink" href="http://packages.debian.org/dblatex" target="_top">Linux Debian</a>,
 
3
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Installing on Unix like Systems</title><link rel="stylesheet" href="manual.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="DocBook to LaTeX Publishing" /><link rel="up" href="sec-install.html" title="Chapter 2. Installing the Package" /><link rel="prev" href="sec-install.html" title="Chapter 2. Installing the Package" /><link rel="next" href="ch02s03.html" title="Installing on Windows" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Installing on Unix like Systems</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sec-install.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing the Package</th><td width="20%" align="right"> <a accesskey="n" href="ch02s03.html">Next</a></td></tr></table><hr /></div><div class="section" title="Installing on Unix like Systems"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-install-unix"></a>Installing on Unix like Systems</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="sec-install-unix.html#id3763532">Dblatex Packages</a></span></dt><dt><span class="section"><a href="sec-install-unix.html#id3765964">Dependencies</a></span></dt><dt><span class="section"><a href="sec-install-unix.html#id3766361">Installation</a></span></dt></dl></div><div class="section" title="Dblatex Packages"><div class="titlepage"><div><div><h3 class="title"><a id="id3763532"></a>Dblatex Packages</h3></div></div></div><p>Dblatex is packaged for these Systems or Distributions:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><a class="ulink" href="http://packages.debian.org/dblatex" target="_top">Linux Debian</a>,
4
4
<a class="ulink" href="http://packages.ubuntu.com/search?keywords=dblatex" target="_top">Ubuntu</a>,</p></li><li class="listitem"><p><a class="ulink" href="http://download.opensuse.org/repositories/home:/thomas-schraitle" target="_top">Linux
5
5
OpenSUSE (RPM)</a>, <a class="ulink" href="https://admin.fedoraproject.org/pkgdb/packages/name/dblatex" target="_top">Linux Fedora
6
6
(RPM)</a>,</p></li><li class="listitem"><p><a class="ulink" href="http://www.freshports.org/textproc/dblatex" target="_top">FreeBSD</a>,
7
7
<a class="ulink" href="http://pkgsrc.se/textproc/dblatex" target="_top">NetBSD</a>,</p></li><li class="listitem"><p><a class="ulink" href="http://pdb.finkproject.org/pdb/package.php/dblatex" target="_top">Mac OS X
8
8
(Fink)</a>.</p></li></ul></div><p> If you are installing on one of these distributions, follow their
9
9
recommended way of installation, and you can safely ignore the next sections
10
 
that give details for installing dblatex from the source tarball.</p></div><div class="section" title="Dependencies"><div class="titlepage"><div><div><h3 class="title"><a id="id3617692"></a>Dependencies</h3></div></div></div><p>To work, the following items must be available:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>An XSLT. <code class="filename">xsltproc</code> is the default XSLT used, but one
 
10
that give details for installing dblatex from the source tarball.</p></div><div class="section" title="Dependencies"><div class="titlepage"><div><div><h3 class="title"><a id="id3765964"></a>Dependencies</h3></div></div></div><p>To work, the following items must be available:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>An XSLT. <code class="filename">xsltproc</code> is the default XSLT used, but one
11
11
can also use <a class="ulink" href="http://4suite.org" target="_top">4suite</a>.</p></li><li class="listitem"><p>The XML DocBook DTD.</p></li><li class="listitem"><p>A recent LaTeX distribution. The configure script checks that the needed
12
 
latex packages are available.</p></li><li class="listitem"><p>Python &gt;= 2.4.</p></li></ul></div></div><div class="section" title="Installation"><div class="titlepage"><div><div><h3 class="title"><a id="id3618089"></a>Installation</h3></div></div></div><div class="toc"><dl><dt><span class="section"><a href="sec-install-unix.html#id3617972">Installing the dependencies</a></span></dt><dt><span class="section"><a href="sec-install-unix.html#id3618016">Installing from the source tarball</a></span></dt><dt><span class="section"><a href="sec-install-unix.html#sec-install-pypi">Installing from the Python Egg</a></span></dt></dl></div><div class="section" title="Installing the dependencies"><div class="titlepage"><div><div><h4 class="title"><a id="id3617972"></a>Installing the dependencies</h4></div></div></div><p>To use the package, install properly the dependencies:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Install Python if necessary.</p></li><li class="listitem"><p>Install LaTeX.</p></li><li class="listitem"><p>Install the XSLT. By default <code class="filename">xsltproc</code> is
 
12
latex packages are available.</p></li><li class="listitem"><p>Python &gt;= 2.4.</p></li></ul></div></div><div class="section" title="Installation"><div class="titlepage"><div><div><h3 class="title"><a id="id3766361"></a>Installation</h3></div></div></div><div class="toc"><dl><dt><span class="section"><a href="sec-install-unix.html#id3766244">Installing the dependencies</a></span></dt><dt><span class="section"><a href="sec-install-unix.html#id3766289">Installing from the source tarball</a></span></dt><dt><span class="section"><a href="sec-install-unix.html#sec-install-pypi">Installing from the Python Egg</a></span></dt></dl></div><div class="section" title="Installing the dependencies"><div class="titlepage"><div><div><h4 class="title"><a id="id3766244"></a>Installing the dependencies</h4></div></div></div><p>To use the package, install properly the dependencies:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Install Python if necessary.</p></li><li class="listitem"><p>Install LaTeX.</p></li><li class="listitem"><p>Install the XSLT. By default <code class="filename">xsltproc</code> is
13
13
used.</p></li><li class="listitem"><p>Install the XML DocBook DTD.</p></li><li class="listitem"><p>Create a catalog file, that defines where to find the DTD. Here is an
14
14
example:</p><pre class="programlisting">
15
15
PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
21
21
                           'file://path/to/4.1.2/docbookx.dtd' mycatalog
22
22
    </pre></li><li class="listitem"><p>Add the catalog path to the SGML_CATALOG_FILES variable:</p><pre class="programlisting">export SGML_CATALOG_FILES=$SGML_CATALOG_FILES:/path/to/mycatalog
23
23
</pre><p>You can skip this step if you configure the dblatex installation with
24
 
the <code class="option">--catalogs</code> option.</p></li></ol></div></div><div class="section" title="Installing from the source tarball"><div class="titlepage"><div><div><h4 class="title"><a id="id3618016"></a>Installing from the source tarball</h4></div></div></div><p>The steps to follow are the following:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Untar the ball. For a bzipped release, do as follow:</p><pre class="screen">% tar xvfj dblatex-x.x.x.tar.bz2</pre><p>For a gzipped release, do as follow:</p><pre class="screen">% tar xvfz dblatex-x.x.x.tar.gz</pre></li><li class="listitem"><p>Install the package. The installation script preliminary checks the
 
24
the <code class="option">--catalogs</code> option.</p></li></ol></div></div><div class="section" title="Installing from the source tarball"><div class="titlepage"><div><div><h4 class="title"><a id="id3766289"></a>Installing from the source tarball</h4></div></div></div><p>The steps to follow are the following:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Untar the ball. For a bzipped release, do as follow:</p><pre class="screen">% tar xvfj dblatex-x.x.x.tar.bz2</pre><p>For a gzipped release, do as follow:</p><pre class="screen">% tar xvfz dblatex-x.x.x.tar.gz</pre></li><li class="listitem"><p>Install the package. The installation script preliminary checks the
25
25
dependencies. In the example, the <code class="filename">dblatex</code> script is
26
26
installed under <code class="filename">/usr/local/bin</code> and the other files are
27
27
installed under <code class="filename">/usr/local/share/dblatex</code>. Besides, the