Pootle on Fedora
================

Welcome to Pootle running on Fedora.  This README offers some Fedora
specific information on Pootle.

0. Installation setup

- Database
You can use sqlite (default) or MySQL.  Sqlite requires no setup.
If you want to use MySQL then see section 3. below.

- Email
You need email for user registration confirmations, edit EMAIL_*
and DEFAULT_FROM_EMAIL in /etc/pootle/localsettings.py


1. Running Pootle

Regardless of how you choose to run Pootle (see below) the first run
will be slow.  This is because the Django database is initialised
and the files statistics are generated.  This is a once off event with
subsequent operations being much faster.

To run Pootle you can use Apache or run Pootle standalone:

- Apache (recommended)
Before running ensure that apache and memcached are running
$ services httpd start
$ services memcached start
Now point your web browser to http://localhost/pootle and Pootle
will run.

- Standalone (not recommended)
Before running ensure that memcached is running
$ services memcached start
Run PootleServer and Pootle will be available on http://localhost:8080

While you can run either of these ways it is recommended that you 
don't mix and match as you can get problems with file permission. Rather
stick to one approach.


2. Post installation

Your administrative user is username: admin, password: admin.  Make sure
that you change that before going live.


3. Optimising Pootle

To make Pootle go faster, especially on larger installations you will want
to do the following:

- Review optimisation hints
Pootle provides admins with various tips for optimisation, check that
your setup is running optimally by visiting:
http://localhost/pootle/admin/

- MySQL database
Pootle will by default use a sqlite database.  If you move to MySQL (or another
RDBMS) you should see improved performance.  Follow the setup instructions
at http://translate.sourceforge.net/wiki/pootle/using_mysql


4. Further information

4.1 Pootle and Version Control

The wiki has a lot of information on setting up the version control system
http://translate.sourceforge.net/wiki/pootle/version_control


4.2 Pootle and Translation Memory (TM)

The updatetm tool is what you want to use to supply translation memory 
suggestions to translators:
http://translate.sourceforge.net/wiki/pootle/updatetm


4.3 Terminology

You can setup a terminology project or terminology file to supply
terminology suggestions to translators:
http://translate.sourceforge.net/wiki/pootle/adding_a_terminology_project


4.4 Changes to Pootle on Fedora

The following changes have been made to a default Pootle setup

Optimisations:
- memcached - this is used by default for better performance
- apache - while Pootle can run standalone Apache provides better performance
  so we have made that standard.
- Xapian - for indexing searches otherwise they're quite slow
- Session stores - we store them in memcached for speed

Important files:
/etc/pootle/localsettings.py       - Pootle configuration file
/var/lib/pootle/dbs/stats.db       - your statistics cache
/var/lib/pootle/dbs/pootle.db      - your Django config, users, etc

Projects:
/var/lib/pootle/po/$project - your translation project files

-- 
Enjoy,
Pootle developers