Translations

Overview

PDFStitcher uses GNU gettext for translation, but you don’t need to be a programmer to contribute. The way translations work is:

  1. The programmer uses a special function to write all the strings in their native language (in this case, English). Strings are text elements like labels and messages.
  2. When the program is updated and ready for translation, a “.pot” file is created with a list of all the strings.
  3. When a new language is added, a “.po” file is created with a list of each English string and a corresponding blank string (“”) to fill in with the other language.
  4. The translator fills in the blanks using a program such as Poedit.
  5. The programmer takes the completed .po file and compiles it in to the program.

PDFStitcher will read your system language and display the correct translation accordingly, if it is supported. If not, consider adding one.

Editing an existing translation file

The preferred way to edit translation files is Poedit. This is a free and open source program; there are some Pro features available, but unless you are a frequent translator the free version does all you need.

The .po files are located here. They are all named “pdfstitcher.po”, but each is in a different subfolder according to the language (e.g. click on fr_FR/LC_MESSAGES to find the French translation file).

When you’re done editing the .po file you can email it to me, or if you’re comfortable using git feel free to upload it directly to github. Don’t worry about making mistakes - the beauty of version control is we can always go back and fix things.

Important: Some of the English messages have placeholders in them as “{}”, which the code will fill in with the appropriate value. The translated version must have the same number of placeholders, otherwise the code will break.

Example: “Tiling with {} rows and {} columns”/”Carrelage avec {} lignes et {} colonnes”.

poedit screenshot

Above is an example of what you might see if you open a partially completed translation file with Poedit. You can click on each row to edit the corresponding translation, and the entries can be sorted from the “View” menu to show suspected errors or missing values first.

Adding a new translation

If you’d like to add a new language, thank you! Let me know by submitting an issue or sending me an email and I’ll create a new .po file for your language.

Updated: