Babel l10n support for Glade, GtkBuilder, and .desktop files
Project description
BabelGladeExtractor
This package contains message catalog extractors for the following formats, extending Babel so it can handle them.
-
The new XML format used by Glade 3.8 and above, properly known as the GtkBuilder UI Definitions format;
-
The older "GladeXML" format used by libglade and older versions of Glade;
-
The GNOME AppData XML dialect, because it's similar;
-
FreeDesktop.org Desktop Entry files.
Getting started
To make these formats translatable, install this package using pip:
pip3 install BabelGladeExtractor
Then in your own projects, map some source and data files to the simple
extractor names "glade" and "desktop" that are provided by this package.
In your setup.py
, add a section like
[extract_messages]
mapping_file = babel.cfg
output_file = subdir/myproject.pot
input_dirs = .
Next, create a separate babel.cfg
file, and add sections to it for
each format you want to translate.
[glade: **.ui]
[desktop: **.desktop]
You can then use Babel's setuptools integration or its command line interface for your routine i18n lifecycle tasks.
python3 setup.py extract_messages
There's a lot more to it than this, naturally. See Babel's extensive Working with Message Catalogs documentation for a detailed explanation of how to get translatable strings into your Python code.
In Glade 3.22, when you are editing a string property in a sidebar, click the edit icon on the right hand side of the text entry. In the dialog that pops up, enter the text in the main text box, and make sure that the Translatable checkbox is ticked. You can also add some helpful context or comments for your translators if you need to give them a hint. BabelGladeExtractor will handle the corresponding XML attributes appropriately when it extracts strings for translation.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for BabelGladeExtractor-0.7.0.tar.bz2
Algorithm | Hash digest | |
---|---|---|
SHA256 | bcf805e28b4bb18c8b6909a65a7cf5c7c2bcbf4ae50b164878c9682d22271798 |
|
MD5 | 10b8d403a06d626c2ee122a084c524f9 |
|
BLAKE2b-256 | 92d1322c28eec415ac3469edf3293958b4a57e7028cb78c5eaa6cd010cffa380 |