Suvarna Garge (Editor)

Gettext

Updated on
Edit
Like
Comment
Share on FacebookTweet on TwitterShare on LinkedInShare on Reddit
Original author(s)
  
Sun Microsystems

Operating system
  
Cross-platform

Developer(s)
  
various

Gettext

Initial release
  
1990; 27 years ago (1990)

Repository
  
various based on OpenSolaris and GNU gettext

Type
  
Internationalization and localization

In computing, gettext is an internationalization and localization (i18n) system commonly used for writing multilingual programs on Unix-like computer operating systems. The most commonly used implementation of gettext is GNU gettext, released by the GNU Project in 1995.

Contents

History

gettext was originally written by Sun Microsystems in the early 1990s. The GNU Project released GNU gettext, a free software implementation of the system in 1995.

Programming

Source code is first modified to use the GNU gettext calls. For most programming languages, this is done by wrapping strings that the user will see in the gettext function. To save typing time, and to reduce code clutter, this function is commonly aliased to _, so that the C code:

would become:

Comments (starting with ///) placed directly before strings thus marked are made available as hints to translators by helper programs.

gettext then uses the supplied strings as keys for looking up alternative translations, and will return the original string when no translation is available. This is in contrast to POSIX catgets, AmigaOS GetString, or the use of LoadString under Microsoft Windows where a programmatic ID (often an integer) is used.

xgettext is run on the sources to produce a .pot (Portable Object Template) file, which contains a list of all the translatable strings extracted from the sources.

For example, an input file with a comment might look like:

xgettext is run using the command:

xgettext -c /

The resultant .pot file looks like this with the comment:

Translating

The translator derives a .po (Portable Object) file from the template using the msginit program, then fills out the translations. msginit initializes the translations so, for instance, for a French language translation, the command to run would be:

msginit --locale=fr --input=name.pot

This will create fr.po. The translator then edits the resultant file, either by hand or with a translation tool like Poedit, or Emacs with its editing mode for .po files. An edited entry will look like:

Finally, the .po files are compiled with msgfmt into binary .mo (Machine Object) files. GNU gettext has its own file name extension: .gmo. These are now ready for distribution with the software package.

Running

The user, on Unix-type systems, sets the environment variable LC_MESSAGES, and the program will display strings in the selected language, if there is an .mo file for it.

The user, on GNU variants, sets the environment variable LANGUAGE (LC_MESSAGES is also supported), and the program will display strings in the selected language, if there is an .mo file for it.

Implementations

In addition to C, GNU gettext has the following implementations: C# for ASP.NET, Scala, and Node.js.

References

Gettext Wikipedia