Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
In-place localization tool
Python JavaScript CSS HTML

This branch is even with mozilla:master

README.md

Pontoon

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.

Installation

  1. Install Docker and Compose.

  2. Clone this repository or your fork:

    $ git clone --recursive https://github.com/mozilla/pontoon.git
    $ cd pontoon
  3. OPTIONAL: If you're running the site via boot2docker, you'll want to add a .env file to the project's root director with the IP address of the boot2docker VM.

    $ echo "SITE_URL=http://$(boot2docker ip):8000" > .env
  4. 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

Local settings

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

Get involved

  • File a bug

  • Read more on the Wiki

  • Join #pontoon on IRC

Servers

License

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

Something went wrong with that request. Please try again.