<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Installation — Translate Toolkit 1.9.0 documentation</title>
<link rel="stylesheet" href="_static/basic.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/bootstrap.css" type="text/css" />
<link rel="stylesheet" href="_static/bootstrap-sphinx.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '1.9.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/bootstrap.js"></script>
<script type="text/javascript" src="_static/bootstrap-sphinx.js"></script>
<link rel="top" title="Translate Toolkit 1.9.0 documentation" href="index.html" />
<link rel="next" title="Converters" href="commands/index.html" />
<link rel="prev" title="Features" href="features.html" />
</head>
<body>
<div id="navbar" class="navbar navbar-fixed-top">
<div class="navbar-inner">
<div class="container-fluid">
<a class="brand" href="index.html">Translate Toolkit</a>
<span class="navbar-text pull-left"><b>1.9.0</b></span>
<ul class="nav">
<li class="divider-vertical"></li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Site <b class="caret"></b></a>
<ul class="dropdown-menu globaltoc"><ul class="simple">
</ul>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="features.html">Features</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="commands/index.html">Converters</a></li>
<li class="toctree-l1"><a class="reference internal" href="commands/index.html#tools">Tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="commands/index.html#scripts">Scripts</a></li>
<li class="toctree-l1"><a class="reference internal" href="guides/index.html">Use Cases</a></li>
<li class="toctree-l1"><a class="reference internal" href="formats/index.html">Supported formats</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="styleguide.html">Translate Styleguide</a></li>
<li class="toctree-l1"><a class="reference internal" href="styleguide.html#documentation">Documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="development/building.html">Building</a></li>
<li class="toctree-l1"><a class="reference internal" href="development/contributing.html">Contributing</a></li>
<li class="toctree-l1"><a class="reference internal" href="development/developers.html">Translate Toolkit Developers Guide</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="api/index.html">API</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="changelog.html">Important Changes</a></li>
<li class="toctree-l1"><a class="reference internal" href="history.html">History of the Translate Toolkit</a></li>
<li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
</ul>
</ul>
</li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Page <b class="caret"></b></a>
<ul class="dropdown-menu localtoc"><ul>
<li><a class="reference internal" href="#">Installation</a><ul>
<li><a class="reference internal" href="#prerequisites">Prerequisites</a></li>
<li><a class="reference internal" href="#building">Building</a></li>
<li><a class="reference internal" href="#download">Download</a></li>
<li><a class="reference internal" href="#installing-packaged-versions">Installing packaged versions</a></li>
<li><a class="reference internal" href="#installing-from-git">Installing from Git</a></li>
<li><a class="reference internal" href="#verify-installed-version">Verify installed version</a></li>
</ul>
</li>
</ul>
</ul>
</li>
<li><a href="features.html"
title="previous chapter">« Features</a></li>
<li><a href="commands/index.html"
title="next chapter">Converters »</a></li>
</ul>
<form class="navbar-search pull-right" action="search.html" method="get">
<input type="text" name="q" placeholder="Search" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</ul>
</div>
</div>
</div>
</div>
<div class="container content">
<div class="section" id="installation">
<span id="id1"></span><h1>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h1>
<p>This is a guide to installing the Translate Toolkit on your system. If the
Translate Toolkit is already packaged for your system, this is probably the
easiest way to install it. For Windows users, we provide installers. For
several Linux distributions, the package might be available through your
package manager.</p>
<p>These packages might not be the absolute newest, or you might want to install
from our packaged releases for some other reason.</p>
<p>If your system already has the toolkit prepackaged, then please let us know
what steps are required to install it.</p>
<div class="section" id="prerequisites">
<span id="installation-prerequisites"></span><h2>Prerequisites<a class="headerlink" href="#prerequisites" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Remove old versions of toolkit on Debian</li>
</ul>
<p>The dollowing advice only applies to manual installation from tar ball.</p>
<ol class="arabic">
<li><p class="first">Find location of your python packages:</p>
<div class="highlight-python"><pre>python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()"</pre>
</div>
</li>
<li><p class="first">Delete toolkit package from your Python site-packages directory e.g.:</p>
<div class="highlight-python"><pre>rm /usr/local/lib/python2.5/dist-packages/translate -R</pre>
</div>
</li>
</ol>
</div>
<div class="section" id="building">
<span id="installation-building"></span><h2>Building<a class="headerlink" href="#building" title="Permalink to this headline">¶</a></h2>
<p>For build instructions, see the <a class="reference internal" href="development/building.html"><em>Building</em></a> page.</p>
</div>
<div class="section" id="download">
<span id="installation-download"></span><h2>Download<a class="headerlink" href="#download" title="Permalink to this headline">¶</a></h2>
<p>Download a stable <a class="reference external" href="http://sourceforge.net/projects/translate/files/Translate%20Toolkit/">released version</a>. Or
if you have a python environment, run <cite>easy_install translate-toolkit</cite>. For
those who need problems fixed, or who want to work on the bleeding edge, get
the latest source from <a class="reference internal" href="#installation-installing-from-git"><em>Git</em></a>.</p>
<p>For most Windows users, the file named “translate-toolkit-...-setup.exe” is the
best choice and contains everything you need if you just want to run Toolkit
commands. If you want to use it for development, you will need to install it
with easy_install or from the source package.</p>
<p>If you install the complete “setup” version in Windows, or if you install
through your distribution’s package manager, you should automatically have all
the dependencies you need. If you are installing from the Version Control
System, or from a source release, you should check the README file for
information on the dependencies that are needed. Some of the dependencies are
optional. The README file documents this.</p>
</div>
<div class="section" id="installing-packaged-versions">
<span id="installation-installing-packaged-versions"></span><h2>Installing packaged versions<a class="headerlink" href="#installing-packaged-versions" title="Permalink to this headline">¶</a></h2>
<p>Get the package for your system:</p>
<table border="1" class="docutils">
<colgroup>
<col width="17%" />
<col width="83%" />
</colgroup>
<tbody valign="top">
<tr class="row-odd"><td>-setup.exe</td>
<td>A complete Windows installer containing all dependencies,
including Python</td>
</tr>
<tr class="row-even"><td>.exe</td>
<td>An installer for a Windows with Python and other
dependencies already installed</td>
</tr>
<tr class="row-odd"><td>RPM</td>
<td>If you want to install easily on an RPM based system</td>
</tr>
<tr class="row-even"><td>.tar.gz</td>
<td>for source based installing on Linux</td>
</tr>
<tr class="row-odd"><td>.deb</td>
<td>for Debian GNU/Linux (etch version)</td>
</tr>
</tbody>
</table>
<p>The RPM package can be installed by using the following command:</p>
<div class="highlight-python"><pre>rpm -Uvh translate-toolkit-1.0.1.rpm</pre>
</div>
<p>To install a tar.bz2:</p>
<div class="highlight-python"><pre>tar xvjf translate-toolkit-1.1.0.tar.bz2
cd translate-toolkit-1.1.0
su
./setup.py install</pre>
</div>
<p>On Windows simply click on the .exe file and follow the instructions.</p>
<p>On Debian (if you are on etch), just type the following command:</p>
<div class="highlight-python"><pre>aptitude install translate-toolkit</pre>
</div>
<p>If you are using an old Debian stable system, you might want to install the
.tar.bz2 version. Be sure to install python and python development first with:</p>
<div class="highlight-python"><pre>apt-get install python python-dev</pre>
</div>
<p>Alternatively newer packages might be in testing.</p>
</div>
<div class="section" id="installing-from-git">
<span id="installation-installing-from-git"></span><h2>Installing from Git<a class="headerlink" href="#installing-from-git" title="Permalink to this headline">¶</a></h2>
<p>If you want to try the bleeding edge, or just want to have the latest fixes
from a stabilising branch then you need to use Git to get your sources.:</p>
<div class="highlight-python"><pre>git clone https://github.com/translate/translate.git</pre>
</div>
<p>This will retrieve the <tt class="docutils literal"><span class="pre">master</span></tt> branch of the Toolkit. Further Git
<a class="reference external" href="http://git.or.cz/course/svn.html">instructions</a> are also available.</p>
<p>Once you have the sources you have two options, a full install:</p>
<div class="highlight-python"><pre>su
./setup.py install</pre>
</div>
<p>or, running the tools from the source directory</p>
<div class="highlight-python"><pre>./setuppath # Only needed the first time
. setpath # Do this once for a session</pre>
</div>
</div>
<div class="section" id="verify-installed-version">
<span id="installation-verify-installed-version"></span><h2>Verify installed version<a class="headerlink" href="#verify-installed-version" title="Permalink to this headline">¶</a></h2>
<p>To verify which version of the toolkit you have installed run:</p>
<div class="highlight-python"><pre>[l10n@server]# moz2po --version
moz2po 1.1.0</pre>
</div>
</div>
</div>
</div>
<hr>
<footer class="footer">
<div class="container">
<p class="pull-right"><a href="#">Back to top ↑</a></p>
<ul class="unstyled muted">
<li><small>
© 2012, Translate.org.za.<br/>
</small></li>
<li><small>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</small></li>
</ul>
</div>
</footer>
</body>
</html>
