Translating the extension

The extension uses the gettext localization framework for multi-language support. You can use any tool compatible with the gettext format to edit or create new translations.

How to improve an existing translation

If you would like to extend or improve an existing translation you have to:

1. Fork the repository
2. Clone your fork locally and create a new branch
3. Open the localization file of your language in your editor of choice. You can find it in the directory src/main/po named with your language code.
4. Update the po file from the pot to get the updated strings to translate
5. Once you have made your changes, save the po file
6. Make sure to add your name in the Language-Team property of the po file. This property should contain a comma separated list of the names of all people that contributed to the translation." This step is important to make sure your contribution is credited in the "About" dialog of the extension.
7. Commit your changes and push them to your fork
8. Create a pull request against master

How to create a new translation

1. Fork the repository
2. Clone your fork locally and create a new branch
3. Create a new po file from the pot located in src/main/po. Save the new file with the two letter language code as the name and .po as extension.
4. Use the name of the language (localized) as Project-Id-Version and put your name in the Language-Team field. This step is important to make sure your contribution is credited in the "About" dialog of the extension.
5. Once you have completed the translation, save the po file
6. Commit your changes and push them to your fork
7. Create a pull request against master