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
To enable localization of your site with Pontoon, simply include the script located at
/static/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.
- Install VirtualBox by Oracle to run our VM.
- Install Vagrant to easily customize and access our VM:
- Clone Pontoon or your fork:
git clone --recursive git://github.com/mathjazz/pontoon.git
- Run a virtual development environment from your working copy directory:
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.
- In not running yet, start the VM from your working copy directory:
- Enter VM:
- Run the development web server (in VM):
python manage.py runserver 0.0.0.0:8000
- Point your web browser to http://localhost:8000.
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).
Django local settings file should be stored at
/pontoon/settings/local.py. Copy contents from
SITE_URL: required for BrowserID, set if different from
SESSION_COOKIE_SECURE = False: uncomment if running a local development install without HTTPS to disable HTTPS-only cookies.
MICROSOFT_TRANSLATOR_API_KEY: set to a valid Microsoft Translator API key to use machine translation.
To use PHP hooks:
/hooks/to your web server's document root.
- Store Pontoon application path in the $path variable in
/hooks/php/local-settings.phpif different from
To extract strings, run:
xgettext -L PHP --keyword=_w --from-code=UTF-8 --output=messages.pot *.php
To sync your repository with upstream changes, just update the code using git:
git pull && git submodule sync --quiet && git submodule update --init --recursive
To only update Playdoh and submodules, do:
git pull playdoh master && git submodule foreach git pull origin master
This software is licensed under the New BSD License. For more information, read the file