Differences between revisions 6 and 7
Revision 6 as of 2006-07-28 18:02:33
Size: 2669
Editor: p54A65828
Revision 7 as of 2006-07-28 18:11:15
Size: 2846
Editor: p54A65828
Comment: launchpad integration added
Deletions are marked like this. Additions are marked like this.
Line 42: Line 42:
=== Launchpad integration ===
Line 44: Line 46:

Line 51: Line 54:
Line 52: Line 57:

those files will be installed in the archive at:


This spec describes what needs to be done to get translated package descriptions in apt.


The current apt does only support package descriptions in a single language. This is English currently. A more flexible mechanism is required to show the translations in the locale the user is using.

Use cases

  • Anne can't speak English at all but would still like to know more about the applications on the system. Currently gnome-app-install displays only a localized short description, the long description is in English.
  • Peter speaks English, but prefers his own language because his English skills are not that good. He is a power-user otherwise and uses aptitude regularly. He would like to see the package descriptions in his local language.
  • Paul is using the default package set and is happy with it. He uses update-manager to update his system regularly and sometimes wonders what the packages he updates are all about. He would like to see the description for them in his locale because he does not speak English.


  • apt needs to be extended to support "Translation" files for the package descriptions.
  • The archive server needs to carry these translation file, this can be done via a custom upload format
  • Tools to convert the Translation files to and from Rosetta needs to be written.
  • Sharing our translation data with the debian project should be possible.


The Translation-$LANG file carries the following information per package:

Package: <package-name>
Description-md5: <the md5 checksum of the english description>
Description-$lang.$encoding: <translated headline>
 <translated section>

Launchpad integration

The tarball for uploads to the archive should be handled via the launchpad custom uploads mechanism. A tarball looks like this:


and it will contain:


those files will be installed in the archive at:


The apt bits are implemented in but need testing. Import/export for rosetta is available in (a bit rought). No code for the custom upload format has been written yet.

Outstanding issues

The code needs testing.


TranslatedPackageDescriptionsSpec (last edited 2008-08-06 16:35:23 by localhost)