Pontoon enables localizers to translate web apps and web sites 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. Localizer Docs.
To enable localization of your site with Pontoon, include a script 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. Developer Docs.
Clone this repository or your fork:
$ git clone --recursive https://github.com/mozilla/pontoon.git $ cd pontoon
OPTIONAL: If you're running the site via boot2docker, you'll want to add a
.envfile to the project's root director with the IP address of the boot2docker VM.
$ echo "SITE_URL=http://$(boot2docker ip):8000" > .env
Build the development instance using the build script:
$ boot2docker up $ eval "$(boot2docker shellinit)" $ ./bin/build-docker.sh
Once you've finished these steps, you should be able to start the site by running:
$ docker-compose up
If you're running Docker directly (via Linux), the site should be available at http://localhost:8000. If you're running boot2docker, the site should be available on port 8000 at the IP output by running:
$ boot2docker ip
For admin access, create admin account with:
$ docker-compose run web ./manage.py createsuperuser
After following the installation instructions above, you can run the automated test suite with the following command:
$ docker-compose run web ./manage.py test
The following settings can be set by creating a
.env file in root directory of
your pontoon repo and adding their values:
MICROSOFT_TRANSLATOR_API_KEY=microsoft-key GOOGLE_ANALYTICS_KEY=google-key MOZILLIANS_API_KEY=mozillians-key
MICROSOFT_TRANSLATOR_API_KEY: set Microsoft Translator API key to use machine translation.
GOOGLE_ANALYTICS_KEY: set Google Analytics key to use Google Analytics.
MOZILLIANS_API_KEY: set Mozillians API key to grant permission to Mozilla localizers.
This software is licensed under the New BSD License. For more information, read the file