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
/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.
- Install VirtualBox by Oracle to run our VM.
- Install Vagrant to easily customize and access our VM:
- Clone Pontoon or your fork to your web server's document root (needed for testing PHP hooks):
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 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
To use Microsoft Translator API for machine translation, obtain a valid API key from the Bing Developer Center and store it in a variable Pontoon._app._mt in your local JS settings file
To use PHP hooks, store Pontoon application path in the $path variable in your local PHP settings file in