(→KBabel) |
(→Internationalisation (i18n) Tools) |
||
| Line 26: | Line 26: | ||
: [http://kbabel.kde.org/ KBabel] is a set of tools for editing and managing gettext PO files. Main part is a powerful and comfortable PO file editor which features full navigation capabilities, full editing functionality, possibility to search for translations in different dictionaries, spell and syntax checking, showing diffs and many more. | : [http://kbabel.kde.org/ KBabel] is a set of tools for editing and managing gettext PO files. Main part is a powerful and comfortable PO file editor which features full navigation capabilities, full editing functionality, possibility to search for translations in different dictionaries, spell and syntax checking, showing diffs and many more. | ||
| − | Also included is a "Catalog Manager", a file manager view which helps keeping an overview of PO files. Last but not least it includes a standalone dictionary application as an additional possibility to access KBabel's powerful dictionaries. KBabel will help you to translate fast and also keep consistent translations. | + | : Also included is a "Catalog Manager", a file manager view which helps keeping an overview of PO files. Last but not least it includes a standalone dictionary application as an additional possibility to access KBabel's powerful dictionaries. KBabel will help you to translate fast and also keep consistent translations. |
| − | + | ; Dr. Klash | |
| − | This little utility, once activated, can present a report about conflicting shortcuts in menus. Not only this is helpful for translators but also for developers. A little hand editing of <tt>`kde-config --localprefix`/share/config/kdeglobals</tt> activates this feature: | + | : This little utility, once activated, can present a report about conflicting shortcuts in menus. Not only this is helpful for translators but also for developers. A little hand editing of <tt>`kde-config --localprefix`/share/config/kdeglobals</tt> activates this feature: |
[Development] | [Development] | ||
| Line 37: | Line 37: | ||
AlwaysShowCheckAccelerators=false | AlwaysShowCheckAccelerators=false | ||
| − | Now pressing F12 will show a dialog containing which accelerators in the currently focussed interface conflict and provide suggestions for new accelerators. If no accelerators conflict or Dr. Klash has nothing to suggest, no popup dialog will not be displayed at all. | + | : Now pressing F12 will show a dialog containing which accelerators in the currently focussed interface conflict and provide suggestions for new accelerators. If no accelerators conflict or Dr. Klash has nothing to suggest, no popup dialog will not be displayed at all. |
| − | With <tt>AutoCheckAccelerators</tt> enabled the dialog will popup automatically if a conflict exists and <tt>AlwaysShowCheckAccelerators</tt> can force the dialog to always popup even if there are no conflicts to report. | + | : With <tt>AutoCheckAccelerators</tt> enabled the dialog will popup automatically if a conflict exists and <tt>AlwaysShowCheckAccelerators</tt> can force the dialog to always popup even if there are no conflicts to report. |
| − | + | ; The XX language | |
| − | This helper language serves as a debugging aid for people finding untranslated strings in applications. If you start your application with the ``xx'' locale, all translated strings will appear with x's. First you have to check out these ``translations'' from l10n/xx and install them. | + | : This helper language serves as a debugging aid for people finding untranslated strings in applications. If you start your application with the ``xx'' locale, all translated strings will appear with x's. First you have to check out these ``translations'' from l10n/xx and install them. |
| − | After you've built l10n/xx and installed it, run your application using the XX locale. This can be done by launching it from the command line like this: | + | : After you've built l10n/xx and installed it, run your application using the XX locale. This can be done by launching it from the command line like this: |
> KDE_LANG=xx kspread | > KDE_LANG=xx kspread | ||
| − | This will start KSpread using the XX locale no matter what your current language setting is. Look for strings that do not have the x's in them. If x's are missing from a string, it could be due to missing i18n calls or even missing or incorrectly generated .pot files. Consult the i18n tutorials for further information. | + | : This will start KSpread using the XX locale no matter what your current language setting is. Look for strings that do not have the x's in them. If x's are missing from a string, it could be due to missing i18n calls or even missing or incorrectly generated .pot files. Consult the i18n tutorials for further information. |
| − | When checking for untranslated strings, be sure to check all the WhatsThis help and tooltips. | + | : When checking for untranslated strings, be sure to check all the WhatsThis help and tooltips. |
=== Examining .po files === | === Examining .po files === | ||
This section contains information about tools for KDE development.
Contents |
A list of tools which are used to analyze a program. This includes debuggers and profilers, for instance.
[Development] CheckAccelerators=F12 AutoCheckAccelerators=false AlwaysShowCheckAccelerators=false
> KDE_LANG=xx kspread
You can look at the translated .po files to see if a string is present and has been translated. For example, here's a portion of l10n/de/messages/kdebase/konqueror.po:
#: konq_mainwindow.cc:3707 konq_tabs.cc:84 msgid "&New Tab" msgstr "Neues &Unterfenster"
The string to be translated is given on the msgid line. The translated string is on the msgstr line. Notice that the exact same string to translate came from konq_mainwindow.cc and also from konq_tabs.cc. This saves the translators from having to translate the same identical string twice.
You can also use KBabel to examine .po files. KBabel is part of the kdesdk module.
| Note |
|---|
| More onformation on writing and translating documentation can be found on the i18n project site. |