Nightmonkey

Differences between revisions 27 and 29 (spanning 2 versions)
Revision 27 as of 2008-11-09 19:49:24
Size: 4762
Editor: catv-89-132-74-80
Comment:
Revision 29 as of 2009-05-08 09:21:21
Size: 4401
Editor: catv-89-132-74-173
Comment: Update collaboration with Debian
Deletions are marked like this. Additions are marked like this.
Line 13: Line 13:
= Features =

Nightmonkey can be used to generate static HTML pages, containing links to the descriptions of given packages in the enormous sized [[https://translations.launchpad.net/ddtp-ubuntu|DDTP templates]]. Also it can indicate if the given string is already translated. The package names in the resulting html files are sorted in alphabetic order, except the file for universe, which is by the popcon values of the packages, so you can begin translating the more popular applications of universe. The input of the program is a package list generated from the .desktop files of app-install-data and the DDTP po templates of the given language.

Line 15: Line 20:
Note that the primary place to do package description translations is Debian, to avoid duplicate work: Translating package descriptions in Debian happens here:
Line 20: Line 25:
When interested in translating a package description, first check if you can translate it in Debian. Merges from Debian will be made periodically. If the schedule is tight and you want to make sure a translation in Debian will be there for the next Ubuntu, you can copy-paste from your just made ddtp translation or, if already translated in Debian, from these directories:

[[ftp://ftp.us.debian.org/debian/dists/sid/main/i18n/|sid]] (unstable), [[ftp://ftp.us.debian.org/debian/dists/lenny/main/i18n/|lenny]] (testing/stable) (open a file for your language and do a search)

Nightmonkey & Launchpad are most useful when translating packages that are not available for translation in Debian, for example the packages in restricted and some elsewhere. Also sometimes Ubuntu's package description may differ from Debian's, in which case Launchpad has to be again used.

= Features =

Nightmonkey can be used to generate static HTML pages, containing links to the descriptions of given packages in the enormous sized [[https://translations.launchpad.net/ddtp-ubuntu|DDTP templates]]. Also it can indicate if the given string is already translated. The package names in the resulting html files are sorted in alphabetic order, except the file for universe, which is by the popcon values of the packages, so you can begin translating the more popular applications of universe. The input of the program is a package list generated from the .desktop files of app-install-data and the DDTP po templates of the given language.
Translations made here will be imported automatically to Ubuntu. however, pushing translations made in Ubuntu to Debian is a semi-automatic process.
Currently, Debian's package description translation system is able to fetch common translations from Launchpad translations regularly, so odds are that translations made in Launchpad will appear in the Debian queue, where it has to be approved. Approval can be done by any two people registered there, so we encourage you to register there and approve your translations that show up as suggestions there.

What is this?

Nightmonkey (formerly DDTP-lp-html, but this name sucks ;)) is a simple tool to generate static HTML pages, which contain links to the translatable descriptions of packages appearing in gnome-app-install.

Why?

Ubuntu includes lots of software packages, which have packacge descriptions, visible in package management tools, such as Synaptic, update-manager, gnome-app-install, etc. Those descriptions are translatable, to make them usable for people not speaking English very well. The problem is the amount of these messages. Translation teams with limited human resources have to somehow decide, which strings to translate. One possible decision is to translate those package desciptions, which are visible in the gnome-app-install application, also known as Applications -> Add/Remove. This is more likely to be seen by new/less technical users, who perhaps don't speak English, so they would find the localized descriptions appearing here more helpful as other places, e.g. Synaptic. Other argument is, that the number of packages appearing here is relatively small, so this subset of strings can be translated by smaller teams in reasonable time.

Debian package translations are one item on NonLanguagePackTranslationDeadline.

Features

Nightmonkey can be used to generate static HTML pages, containing links to the descriptions of given packages in the enormous sized DDTP templates. Also it can indicate if the given string is already translated. The package names in the resulting html files are sorted in alphabetic order, except the file for universe, which is by the popcon values of the packages, so you can begin translating the more popular applications of universe. The input of the program is a package list generated from the .desktop files of app-install-data and the DDTP po templates of the given language.

Collaboration with Debian

Translating package descriptions in Debian happens here:

Translations made here will be imported automatically to Ubuntu. however, pushing translations made in Ubuntu to Debian is a semi-automatic process. Currently, Debian's package description translation system is able to fetch common translations from Launchpad translations regularly, so odds are that translations made in Launchpad will appear in the Debian queue, where it has to be approved. Approval can be done by any two people registered there, so we encourage you to register there and approve your translations that show up as suggestions there.

Get it

The software is located in: https://code.launchpad.net/~sianis/ddtp-lp-html/devel

Usage

  • If you want the resulting html pages localized, translate the po/nightmonkey.pot file, rename it according to your locale, e.g. pt_BR.po, hu.po
  • Run prepare.sh - This will compile the source, download and copy .desktop files to their place (and make sure that sun-java6-jdk is installed)
  • Go to https://translations.launchpad.net/ddtp-ubuntu/ubuntu/+translations and download the po files for your language. Place them to the html-generator/po_files directory.

  • Run html-generator/generate.sh - This will generate the html pages for all po files in the po_files directory
  • Put the resulting html files from the html-generator directory online, tell it's location to your translation team members, create a wiki page (like this) for coordination and start translating!

In action

Currently, Nightmonkey generates statistics for all languages at: http://potter.iit.uni-miskolc.hu/~sianis/nightmonkey/ The statistics can be updated on demand (be patient, this takes some time).

You can see the generated html pages for Hungarian at:
http://potter.iit.uni-miskolc.hu/~sianis/nightmonkey/main-hu.html
http://potter.iit.uni-miskolc.hu/~sianis/nightmonkey/universe-hu.html
http://potter.iit.uni-miskolc.hu/~sianis/nightmonkey/multiverse-hu.html
http://potter.iit.uni-miskolc.hu/~sianis/nightmonkey/restricted-hu.html

Contact

The project page is: https://launchpad.net/ddtp-lp-html Use it for bugs, translations, and in case you have questions.

Nightmonkey (last edited 2010-02-10 18:41:28 by catv-89-132-76-245)