View source for Verbatim:Development/Dev Instance

[[Verbatim]] &raquo; Development / Dev Instance

== Setting up a Pootle development instance ==
Pootle's installation instructions are on the [http://translate.sourceforge.net/wiki/pootle/installation_1.3beta Pootle wiki]. Make sure to follow the (django-based) installation instructions, not the ones referring to jToolkit.

* have Python 2.5/2.6 installed
* grab an svn checkout of the Pootle trunk:
** <code>svn co https://translate.svn.sourceforge.net/svnroot/translate/src/trunk pootle</code> ... or
** <code>git svn clone -Ttrunk https://translate.svn.sourceforge.net/svnroot/translate/src/ pootle</code>
** if you are using <code>git-svn</code>, make sure to generate an empty <code>dbs</code> directory, as git won't pick up empty directories [http://sourceforge.net/mailarchive/forum.php?thread_name=4A37D896.3070403%40mozilla.com&forum_name=translate-devel]
* create a clean Python environment for the application, using [http://pypi.python.org/pypi/virtualenv virtualenv] (you don't want to install all required libs in your global python directory):
** <code>virtualenv --no-site-packages --python=path/to/python2.[5|6] pootle-env</code>
** <code>cd pootle-env/</code>
** <code>. bin/activate</code>
* Install the [http://translate.sourceforge.net/wiki/pootle/installation_1.3beta#pre-requisite_software pre-requisites]. Some notes:
** PyLucene and Xapian are not vital
** The translate toolkit is part of the Pootle project too, and while it comes with an svn checkout of the trunk you still need to install it:
*** <code>cd pootle</code>
*** <code>python setup.py install</code>
* Initialize the database by running the <code>./PootleServer</code> script once.
** '''Note for OS X users:''' At this point I got an error that lxml was not installed. Running <code>easy_install lxml</code> didn't work for me, but it might work for you. Instead what I had to do was download the  [http://codespeak.net/lxml/lxml-2.2.1.tgz lxml .tqz] and then:
***<code>tar -xvzf lxml-2.2.1.tgz</code>
***<code>cd lxml-2.2.1</code>
***<code>python setup.py build --static-deps</code>
***<code>python setup.py install</code>
**The issue apparently is that lxml requires newer versions of the libxml and libxslt libraries than the system offers. Building from source with the --static-deps flag will force lxml to download the versions it needs and link against those. More details are available on the [http://codespeak.net/lxml/build.html#building-lxml-on-macos-x lxml website].

* You can run the pootle server later by using <code>./manage.py runserver PORTNUMBER</code> (if you omit PORTNUMBER, it'll default to 8000) [http://translate.sourceforge.net/wiki/pootle/installation_1.3beta#running_pootle]