LangpacksDesktopfiles
Size: 3204
Comment:
|
Size: 4417
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 2: | Line 2: |
##(see the SpecSpec for an explanation) | |
Line 6: | Line 5: |
* '''People''': MartinPittLead, CarlosPerelloMarinSecond, ZygmuntKrynicki * '''Contributors''': * '''Packages affected''': TBD |
* '''Contributors''': JordiMallach, MartinPitt, CarlosPerelloMarin, ZygmuntKrynicki * '''Packages affected''': intltool, libbonobo (?), glib, pyxdg, gnome-desktop (?) |
Line 12: | Line 10: |
Some translatable files do not use gettext at runtime, but rather contain all translations in a single file, like .desktop and .server files. We want to find a robust and generic way to update these translations through Rosetta and language packs. | Some translatable files do not use gettext at runtime, but rather contain all translations in a single file, like .desktop, .server and .directory files. We want to find a robust and generic way to update these translations through Rosetta and language packs. |
Line 23: | Line 21: |
The Gnome libraries that evaluates desktop/server/directory files should just use gettext() to translate entries since application's *.mo files already ship the translations. | |
Line 24: | Line 24: |
There are two ways how to achieve this goal: | In the past we proposed the extension of the [http://standards.freedesktop.org/desktop-entry-spec/latest/ FreeDesktop standard] to support an additional field TranslationDomain, so that Gnome, KDE, and other implementations can find the matching .mo file at runtime to get additional translations from it. However, since this has been rejected upstream, we will use our own Ubuntu specific field for this. |
Line 26: | Line 26: |
=== Parallel hierarchy === * pkgstriptranslations will store .desktop and .server files in translation tarballs. * Rosetta will export a file that maps .desktop/.server file names to translation domains. * langpack-o-matic uses intltool/homebrew script to add new translations to those files. * We create a new package desktop-translations which ships files in parallel directory hierarchies /usr/share/applications-langpack/ and /usr/lib/bonobo/servers-langpack/; those files are preferred over the files in the original directory. It only requires very few changes to lookup files into these additional directories. We just have to make sure that the desktop backend that is responsible for that ignores files whose application is not installed. * desktop-translations can be updated after the release to provide new desktop files. === Switch to use gettext === The Gnome library that evaluates desktop/server files should just use gettext() to translate entries since application's *.mo files already ship the translations. Therefore we want to propose the extension of the [http://standards.freedesktop.org/desktop-entry-spec/latest/ FreeDesktop standard] to support an additional field TranslationDomain, so that Gnome, KDE, and other implementations can find the matching .mo file at runtime to get additional translations from it. Note that most upstream packages already use gettext to translate .desktop files at build time. This could require some caching to speed up the process. |
Note that most upstream packages already use gettext to translate .desktop files at build time. For this packages we only need to change intltool to put the translation domain into the destination files. |
Line 42: | Line 30: |
A proposed domain key is: | === .desktop/.directory file format === |
Line 44: | Line 32: |
{{{ X-Gettext-Domain }}} |
* We will use the key `X-Ubuntu-Gettext-Domain` for storing the translation domain in .desktop-like files. * `intltool-merge --desktop-style` needs to put the translation domain into the destination file. |
Line 48: | Line 35: |
=== Code === | === .server file format === |
Line 50: | Line 37: |
pyxdg is patched to support gettext, check out this bug https://launchpad.net/distros/ubuntu/+source/pyxdg/+bug/3697 |
* We will add a Ubuntu-specific attribute and add Ubuntu translations to the `<oaf_server>` tag (`ubuntu-gettext-domain`). * `intltool-merge --ba-style` needs to put the ubuntu-gettext-attribute in the <oaf_server> stanza in the destination file. This implies parsing XML. |
Line 53: | Line 40: |
=== Data preservation and migration === | === gnome library changes === |
Line 55: | Line 42: |
No data needs to be preserved when adding data to language packs. | pyxdg and libgnome-desktop have patches to support gettext: * https://launchpad.net/distros/ubuntu/+source/pyxdg/+bug/3697 * https://launchpad.net/distros/ubuntu/+source/gnome-desktop/+bug/3723/ gnome-panel is moving to use glib's GKeyFile and libgnome-desktop's parser is being set as deprecated. We should patch glib to support this new system. === KDE === KConfig will need an i18n call if it does not find the translated string in the .desktop file. i18n is done by KLocale and we will need to be careful not to create recursion between KConfig and KLocale. KDE extracts .desktop files into .po files using createdesktop.pl (and supporting scripts in l10n/scripts in KDE's SVN). Use this script to generate .pot files that we will ship. We will modify this script to get it to add the gettext domain to the .desktop files. |
Line 59: | Line 56: |
== BoF agenda and discussion == | * Coordination with Xubuntu. * If performance becomes an issue, we need to think about adding pre-caching of the translations. * SuSE uses one large .po file for this as operations such as loading the k-menu might be too slow with lots of smaller .po files. === Random ideas about performance improvements === * Regenerating the desktop files at language postinst time does not work, since this does not take desktop files into account that are installed after the language pack installation. * apt hooks are not generic enough to support updating files when a new package is installed. There are no dpkg hooks, as they are considered evil. However, if dpkg hooks should be available at one day, they could be utilized for pregenerating translated files. * Modify postinst files with a debhelper hook which asks for updating translations in files. |
Launchpad Entry: https://launchpad.net/distros/ubuntu/+spec/desktop-file-translations
Created: 2005-10-25 by MartinPitt
Contributors: JordiMallach, MartinPitt, CarlosPerelloMarin, ZygmuntKrynicki
Packages affected: intltool, libbonobo (?), glib, pyxdg, gnome-desktop (?)
Summary
Some translatable files do not use gettext at runtime, but rather contain all translations in a single file, like .desktop, .server and .directory files. We want to find a robust and generic way to update these translations through Rosetta and language packs.
Rationale
Currently the language packs contain only translations for desktop applications that use gettext. However, there are many more translatable items in Ubuntu. Our goal is to extract all translatable contents from application packages, import them into Rosetta, and ship them into language packs so that they can be updated after a release and benefit from Rosetta updates.
Scope and use cases
- Sjoerd adds a Dutch translation to a menu entry of a Breezy application in Rosetta. Breezy users should get this new translation with the next language pack update.
Design
The Gnome libraries that evaluates desktop/server/directory files should just use gettext() to translate entries since application's *.mo files already ship the translations.
In the past we proposed the extension of the [http://standards.freedesktop.org/desktop-entry-spec/latest/ FreeDesktop standard] to support an additional field TranslationDomain, so that Gnome, KDE, and other implementations can find the matching .mo file at runtime to get additional translations from it. However, since this has been rejected upstream, we will use our own Ubuntu specific field for this.
Note that most upstream packages already use gettext to translate .desktop files at build time. For this packages we only need to change intltool to put the translation domain into the destination files.
Implementation
.desktop/.directory file format
We will use the key X-Ubuntu-Gettext-Domain for storing the translation domain in .desktop-like files.
intltool-merge --desktop-style needs to put the translation domain into the destination file.
.server file format
We will add a Ubuntu-specific attribute and add Ubuntu translations to the <oaf_server> tag (ubuntu-gettext-domain).
intltool-merge --ba-style needs to put the ubuntu-gettext-attribute in the <oaf_server> stanza in the destination file. This implies parsing XML.
gnome library changes
pyxdg and libgnome-desktop have patches to support gettext:
https://launchpad.net/distros/ubuntu/+source/pyxdg/+bug/3697
https://launchpad.net/distros/ubuntu/+source/gnome-desktop/+bug/3723/
gnome-panel is moving to use glib's GKeyFile and libgnome-desktop's parser is being set as deprecated. We should patch glib to support this new system.
KDE
KConfig will need an i18n call if it does not find the translated string in the .desktop file. i18n is done by KLocale and we will need to be careful not to create recursion between KConfig and KLocale.
KDE extracts .desktop files into .po files using createdesktop.pl (and supporting scripts in l10n/scripts in KDE's SVN). Use this script to generate .pot files that we will ship. We will modify this script to get it to add the gettext domain to the .desktop files.
Outstanding issues
- Coordination with Xubuntu.
- If performance becomes an issue, we need to think about adding pre-caching of the translations.
- SuSE uses one large .po file for this as operations such as loading the k-menu might be too slow with lots of smaller .po files.
Random ideas about performance improvements
- Regenerating the desktop files at language postinst time does not work, since this does not take desktop files into account that are installed after the language pack installation.
- apt hooks are not generic enough to support updating files when a new package is installed. There are no dpkg hooks, as they are considered evil. However, if dpkg hooks should be available at one day, they could be utilized for pregenerating translated files.
- Modify postinst files with a debhelper hook which asks for updating translations in files.
LangpacksDesktopfiles (last edited 2008-08-06 16:30:07 by localhost)