GRASS messages translation: Difference between revisions
(moved up Weblate section) |
|||
| Line 1: | Line 1: | ||
== GRASS messages translation project == | == GRASS messages translation project == | ||
Revision as of 14:51, 5 May 2023
GRASS messages translation project
Many users prefer to use software in their mother tongue which is mostly not English. This requires that all GRASS software messages have to be translated to languages other than English. The GRASS Development Team is seeking translators. Please subscribe to the dedicated mailing list at
GRASS translations mailing list
http://lists.osgeo.org/mailman/listinfo/grass-translations
Translation related issues may be discussed there. This is an opportunity for non-programmers to contribute as messages can be easily translated. No programming skills required!
- Join the team
Wanted languages
Simple Chinese, Swahili, Hindi, Greek, Tamil, Russian, Telugu, Português, ... Please join us!
How to change the language
- see Testing different languages below.
Weblate translation platform
Weblate is a web-based translation tool with tight version control integration. It features a simple and clean user interface, propagation of translations across components, quality checks and automatic linking to source files.
(Note that we migrated from Transifex to Weblate in 2023. All messages on Transifex have been transferred to Weblate.)
How to translate
NOTE: THIS IS FOR TRANSLATOR
- For terminology, please refer to the GRASS Translation Glossary.
Register yourself on the Weblate website using the OSGeo-ID, and start to translate (grasswxpy is the GUI translation and it should be the first translated).
Using the machine translation tool
Using the machine translation tool: We have added the DeepL.com API which helps for selected languages to come to speed with translations.
Usage: login to Weblate. Then you see a button "Automatic suggestion". Use "Clone Translation" to copy over the suggested translation, edit as needed and save it.
Automated upload of your translation work to the GRASS GIS project in GitHub
Every 24 hours the new translations are automatically pushed to https://github.com/OSGeo/grass/pulls. One of the maintainers will take care to merge them into the code so that it becomes part of the next release.
Files to be edited
GRASS GIS 8
In GRASS GIS 8, we have only 3 types of .po files per language (the files are stored in the source code, in directory locale/po/):
(click to see the GRASS GIS Weblate pages)
- grasslibs_LANG.po: messages from libraries
- grassmods_LANG.po: messages from commands ("modules")
- grasswxpy_LANG.po: messages from wxgrass/wxPython graphical user interface
where "LANG" in the above file names is a two character code which indicates the language. It is based on the Alpha-2 code of ISO 639-1 (right column). Example: grasswxpy_pl.po for Polish.
We highly recommend to use our Weblate server: https://weblate.osgeo.org/projects/grass-gis/
Continuing an existing translation
The file(s) are there but partially outdated? Read on.
First announce on the GRASS translations mailing list that you plan to continue the translation of a certain language. Why? Because sometimes people silently translate already and we need these efforts to be coordinated to avoid doing it twice...
Then get these four .po files for your language and start. If a file is missing, just ask on the list to get it generated or see next section. To get these .po files (the files are in the directory locale/po/):
- either download current .po files directly from SVN (click on file name to download),
- or download source code package from GitHub,
- or download the recent source code snapshot,
- or ask on the GRASS translations mailing list for these files.
Then edit the files with a .po file editor (poEDIT or kbabel or..., see below). Take care to maintain layout and special characters. And submit often - if you wait for weeks, the messages may already be outdated and your time wasted. Just keep in touch on the GRASS translations mailing list!
Starting a new translation
The language you want isn't yet there? Read on.
Briefly, the steps to create new messages files are (if you find this too complicated, ask on the GRASS translations mailing list to get these files done for you!):
- Get the latest source code development version from either the SVN repository or as SVN snapshot (see Download).
- run: './configure --with-nls [... other parameters]' to configure the GRASS source code
- run: 'cd locale' to change into the translation directory
- run: 'make pot' to create grass*.pot template files (to extract original messages)
- run: copy these file from templates/ into po/; rename them to contain the two characters language code (see Alpha-2 code of ISO 639-1) and to .po extension; update the file headers either manually or with your .po editing software
(Example: Polish language): mv ./templates/grasslibs.pot ./po/grasslibs_pl.po mv ./templates/grassmods.pot ./po/grassmods_pl.po mv ./templates/grassnviz.pot ./po/grassnviz_pl.po mv ./templates/grasstcl.pot ./po/grasstcl_pl.po mv ./templates/grasswxpy.pot ./po/grasswxpy_pl.po
Now translate the messages in these po/*.po files (using poEDIT or other editor, see below)
From time to time messages need to be updated from the originals. This is usually done by the GRASS translation manager.
Create a new project
NOTE: CORE DEVELOPERS ONLY!
TODO 2023: improve this section!
A project should be done for each stable release, only an Organization Administrators can create a project. From the dashboard in the left bottom corner there is "New project" button. Fill all the field in the form. More info in Weblate documentation
Once the new project is created you need to upload the resources (the pot file to translate). To create the pot files you can execute
make pot
inside the locale folder. Now you can load in the Resource section, after you added them you can link the pot file with an online version to get updates. To do this click on "Auto update resources" bottom (read also the Weblate documentation.
At this point you need to load the translated po files, for each language and file you have to upload the translation po file. Some errors could appear, resolution of this problems is a TODO
Get the translated po files
NOTE: THIS IS FOR DEVELOPERS OR POWER USERS
Testing different languages in GRASS GIS
Testing different languages requires that the respective language environment and, if needed, fonts are installed. Check what languages are currently installed on your system with:
locale -a
To change to a certain language environment (locale), do the following steps (here, example for Unix style environment):
1. Define/check language settings:
echo $LANG
echo $LANGUAGE
echo $LC_MESSAGES
2. Change it (example for to Japanese):
a) bash shell:
export LANG=ja_JP.UTF-8
export LANGUAGE=ja_JP.UTF-8
export LC_MESSAGES=ja_JP.UTF-8
b) (t)csh shell:
setenv LANG ja_JP.UTF-8
setenv LANGUAGE ja_JP.UTF-8
setenv LC_MESSAGES ja_JP.UTF-8
Now launch GRASS in this terminal. If you launch it from an icon, you have to change the LOCALE in the computer setup program instead.
Other common languages useful for testing are de_DE for German, fr_FR for French, or "C" for none (effectively en_US, which for GRASS is the base language).
Creating startup scripts for different languages
GRASS in English language, save as "grass78eng" (executable flag set, store in path):
#!/bin/sh
export LANG=en_US
export LANGUAGE=en_US
export LC_MESSAGES=en_US
exec grass78 "$@"
GRASS in Japanese language, save as "grass78ja" (executable flag set, store in path):
#!/bin/sh
export LANG=ja_JA.UTF-8
export LANGUAGE=ja_JA.UTF-8
export LC_MESSAGES=ja_JA.UTF-8
grass78 "$@"
Coordination among translators
If several translators work on the same language files, obviously some coordination is needed. Please announce work via the "translations" mailing list at https://lists.osgeo.org/mailman/listinfo/grass-translations
Also the translation manager is listening there to the upload the changed files into the GRASS source code repository.
Best practices
- Italiano: Regole per la buona traduzione
Installation of language packages
Example: Chinese
- Debian, Fedora, Ubuntu, ...: the locales should be already present
- list all valid locales on the system: localectl list-locales
- show current settings: localectl status
- set new locale: localectl set-locale LANG=zh_CN.utf8 LC_MESSAGES=zh_CN.utf8
Reduction of similar messages
Please re-use existing messages:
Updating messages in the source code
Generally, to support i18N multiple languages, message strings in GRASS must be modified by adding so-called gettext macros _("...").
C programming language
Change from
fprintf ( ..., "...\n", ...);
to either
fprintf ( ..., _("...\n"), ...);
or usually (while omitting \n)
G_message ( _("..."), ...);
Python programming language
In Python, the macro is used like this:
grass.message(_('Raster map <{name}> unpacked'.format(name=map_name)))
Important hints
Beware:
- G_message should be used for messages - information about the process for user while fprintf(stdout...) for data output.
- G_message output is not expected to be send to pipe or file.
- fprintf(stdout...) output is usually send to pipe or file.
Programming details are available in the file locale/README.
Important:
- Message Standardization: How should Errors/Warnings/Messages be formatted, Macros etc
See also
- Alpha-2 code of ISO 639-1 (right column)