This module provides internationalisation and localisation functionality.
To use this module, just do:
i18n = import('i18n'). The following functions will then be available as methods on the object with the name
i18n. You can, of course, replace the name
i18n with anything else.
Sets up gettext localisation so that translations are built and placed into their proper locations during install. Takes one positional argument which is the name of the gettext module.
languages: list of languages that are to be generated. As of 0.37.0 this is optional and the LINGUAS file is read.
data_dirs: (Added 0.36.0) list of directories to be set for
GETTEXTDATADIRSenv var (Requires gettext 0.19.8+), used for local its files
preset: (Added 0.37.0) name of a preset list of arguments, current option is
'glib', see source for for their value
args: list of extra arguments to pass to
xgettextwhen generating the pot file
This function also defines targets for maintainers to use: Note: These output to the source directory
xgettextto regenerate the pot file
<project_id>-update-po: regenerates the
.pofiles from current
<project_id>-gmo: builds the translations without installing
This merges translations into a text file using
msgfmt. See custom_target for normal keywords. In addition it accepts these keywords:
po_dir: directory containing translations, relative to current directory
data_dirs: (Added 0.41.0) list of directories for its files (See also
type: type of file, valid options are
The results of the search are