Pontoon is a live website localization tool. Instead of extracting original strings and then merging translated strings back, Pontoon can turn any website into editable mode using the contentEditable attribute.

This enables localizers to translate websites in-place with context and spatial limitations right in front of them. A full list of extracted strings is also available, to help with strings that are hard to reach, e.g. error messages and the <title> tag.

To enable localization of your site with Pontoon, simply include the script located at /media/js/project/pontoon.js to overcome cross frame scripting, and Pontoon will autodetect strings. Or, to make the best out of Pontoon, fully prepare your site with hooks that will mark strings for localization and include all the neccessary tags.

Pontoon uses Playdoh, which supports running web apps in virtual machines. This is an ideal way to get started developing Pontoon quickly without dealing with dependancies, compiling things and polluting your development system.

1. Install VirtualBox by Oracle to run our VM.
2. Install Vagrant to easily customize and access our VM:

• gem install vagrant (requires Ruby and gem, but most modern *NIX systems already have them)

3. Clone Pontoon or your fork to your web server's document root (location needed for testing PHP hooks):

• git clone --recursive git://github.com/mathjazz/pontoon.git

4. Run a virtual development environment from your working copy directory:

• cd pontoon
• vagrant up

If you’re running it for the first time, vagrant up will take a few minutes to download base VM image, boot Ubuntu VM, install all the necessary packages and run initialization scripts.

You can edit files in your working copy directory (/pontoon) locally and they will automatically show up under /home/vagrant/pontoon in the VM without any weird FTPing.

1. In not running yet, start the VM from your working copy directory:

• vagrant up

2. Enter VM:

• vagrant ssh

3. Run the development web server (in VM):

• cd pontoon
• python manage.py runserver 0.0.0.0:8000

4. Point your web browser to http://localhost:8000 and click Demo.

Note that you’ll need to explicitly set the host and port for runserver to be accessible from outside the VM. Vagrant setup already forwards port 8000 (the usual Django development port).

To sync your repository with upstream changes, just update the code using git:

git pull && git submodule sync --quiet && git submodule update --init --recursive

Specify your SITE_URL in the Django local settings file apps/settings/local.py if different from http://localhost:8000.

To use Microsoft Translator API for machine translation, obtain a valid API key from the Bing Developer Center and store it in a variable MICROSOFT_TRANSLATOR_API_KEY in your Django local settings file /apps/settings/local.py.

To use PHP hooks, store Pontoon application path in the $path variable in your local PHP settings file in hooks/php/local-settings.php if different from http://localhost:8000.

• Join #pontoon on IRC
• Follow us on Twitter
• Read more on Wiki

This software is licensed under the New BSD License. For more information, read the file LICENSE.