Development/Tutorials/Localization/i18n (de)
| Anleitungsserie | Lokalisation |
| Voriges Kapitel | Introduction to Unicode ist empfohlen wenn auch nicht notwendig |
| Nächstes Kapitel | Häufige Fehler vermeiden |
| Weiterführende Texte | n/a |
| Navigation | Deutsche Startseite |
Zusammenfassung
Eine breite Schar an Benutzern und Entwicklern zu erreichen erfordert, dass Ihre Software übersetzt werden kann und sich auch anderweitig an sprachliche und kulturelle Gegebenheiten desjenigen anpassen kann, der Ihre Applikation benutzt. Das ist die Aufgabe von Lokalisation und diese Anleitung leitet Sie durch die grundlegenden Schritte, Ihre Applikation lokalisierungsfähig zu machen.
Was ist Internationalisation and Lokalisation?
Internationalisation, oder i18n ('i', gefolgt von 18 Buchstaben und dann ein 'n'), bezeichnet den Prozess, Ihre Applikation so zu schreiben, dass sie in jeder beliebigen Sprache und Kultur laufen kann. Dabei müssen folgende Dinge berücksichtigt werden:
- Textmitteilungen, die dem Benutzer mitgeteilt werden
- Dateneingabe vom Benutzer, Dateien und anderen Quellen
- Das Format von Datum, Zahlen, Währungen, etc.
Lokalisation, oder l10n ('l' gefolgt von 10 Zeichen und dann ein 'n') ist der Prozess, eine internationalisierte Applikation an bestimmte lokale Gegebenheiten anzupassen.
Im allgemeinen internationalisieren Programmierer ihre Applikationen und Übersetzerteams lokalisieren sie.
Warum ist das wichtig?
KDE Entwicklung findet primär in Englisch statt, da dies eine breite Entwickler- und Übersetzerschaft erreicht. Englisch ist jedoch nicht die Muttersprache der meisten Menschen auf der Welt. Tatsächlich sprechen weniger als 8% der Menschheit Englisch und weniger als 5% sprechen es als Muttersprache. Auch im Internet benutzen nur 35% der Menschen die online sind Englisch als primäre Sprache und je mehr Teile der Welt an das Internet angeschlossen werden, desto geringer wird dieser Anteil werden. Zusätzlich benutzen die meisten sprachen, alleine 9 der 10 häufigsten, nicht-ASCII Zeichen in ihrer geschriebenen Form. Daher ist es einfach zu erkennen, warum es notwendig ist, Software zu lokalisieren.
Als internationales Projekt das den gesamten Globus umspannt, ist diese Lokalisation ein wichtiges Gut der KDE Kultur. Tatsächlich entwickeln viele KDE Entwickler ihre Applikationen in Englisch, benutzen jedoch ihren KDE-Desktop in der jeweils lokalisierten Version.
Übersetzbaren Code mit i18n()
Um sicherzustellen, dass Ihre Applikation für eine Lokalisation vorbereitet ist, müssen Sie einigen wenigen einfachen Regeln folgen. Alle für Benutzer sichtbaren Zeichenketten Ihrer Applikation sollten übersetzt werden, bevor Sie auf dem Bildschirm des Benutzers dargestellt werden, ausgenommen davon sind Debug-Ausgaben, Konfigurationsdaten und andere ähnliche Textdaten.
KDE stellt als Teil von libkdecore die Klasse KLocale zur Verfügung, um die technischen Aspekte der Lokalisierung zu erledigen. KLocale macht es Entwicklern so einfach wie möglich, ihren Code i18n fähig zu machen, dennoch bleiben einige Dinge, die Sie als Entwickler beachten müssen, damit die Applikation in anderen Sprachen und Ländern eingesetzt werden kann.
Zugriff auf das globale KLocale Objekt wird über KGlobal::locale() zur Verfügung gestellt. Dieses Klocale Objekt wird automatisch von KInstance erzeugt und kümmert sich um alle i18n betreffenden Einstellungen. Beim Verlassen der Applikation wird das Objekt automatisch gelöscht.
Übersetzungen werden von der i18n(const char*) Methode von QString ermöglicht, definiert in klocalizedstring.h. Darin müssen alle Zeichenketten, die dargestellt werden, eingebettet werden. Der von i18n() zurückgegebene QString ist die (wenn nötig) übersetze Zeichenkette. Dadurch werden übersetzbare Widgets sehr einfach möglich, wie das nachfolgende Beispiel zeigt:
#include <klocalizedstring.h>
[...]
QPushButton* myButton = new QPushButton(i18n("Translate this!"));Die native Unicode-Unterstützung von QString stellt sicher, das alle Übersetzungen richtig dargestellt werden. Alle Zeichenkettenbehandlungen Ihrer Applikation sollten daher QString benutzen.
ki18n
Die i18n() Methode benötigt ein existierendes KInstance (z.B. ein KApplication) Objekt. Für Zeichenketten die vor der Erzeugung erstellt werden muss eine andere Methode zur Verfügung gestellt werden: ki18n. Diese erlaubt es, Zeichenketten zur späteren Übersetzung zu markieren. ki18n() gibt ein KLocalizedString zurück, welches letztlich in ein QString konvertiert wird (also schließlich übersetzt wird), nachdem KInstance erzeugt wurde. Dabei wird dessen toString() Methode benutzt.
ki18n() wird typischerweise in Zeichenketten benutzt, die an KAboutData übergeben werden, da dieses von KApplication erzeugt wird. Außerhalb dieser Sonderfälle kann man immer ohne Bedenken i18n() benutzen, wenn man sicher ist, dass dieser Code ausgeführt nachdem KApplication oder eine andere KInstance konstruiert wurde.
Kontext hinzufügen
Es gibt eine erweiterte Version von i18n(), i18nc(), die zwei const char* Argumente übernimmt. Das erste Argument ist eine zusätzliche Beschreibung des Kontext, in dem die zweite Zeichenkette übersetzt wird. Die erste Zeichenkette wird dabei benutzt, um zur Laufzeit die zum Kontext passende Übersetzung finden und wird den Übersetzer angezeigt, um diesen zu helfen, die Bedeutung der Zeichenkette zu verstehen.
Benutzen Sie i18nc() immer dann, wenn der Sinn des Textes mehrdeutig sein kann ohne die Angabe eines Kontext. Stellen Sie sich zum Beispiel das Kontextmenü eines Dateimanagers vor, in dem ein Eintrag namens "View" existiert, die einen Betrachter für die momentan ausgewählte Datei startet. In diesem Kontext ist "View" ein Verb. In der gleichen Applikation könnte jetzt aber auch ein Menüeintrag namens "View" existieren und in diesem Kontext ein Nomen sein. In der englisches Version dieser Applikation würde jetzt alles in Ordnung aussehen, doch in den meisten anderen Spreachen wären diese beiden "View" Zeichenketten nicht gleich.
Zusätzlich benötigen Übersetzer bei ihrer Arbeit manchmal zusätzliche Hilfe zu verstehen, worauf sich der aktuelle Text gerade bezieht.
Im obigen Beispiel des Dateimanagers könnte man daher schreiben:
contextMenu->addAction(i18nc("verb, to view something", "View"));
viewMenu->addAction(i18nc("noun, the view", "View"));Jetzt wären diese beiden Zeichenketten angemessen zu übersetzen, sowohl für den menschlichen Übersetzung als auch zur Laufzeit für KLocale.
Benutzen Sie diese Form von i18n immer dann, wenn die Zeichenkette, die übersetzt werden soll, kurz ist oder die Bedeutung schwer zu entscheiden ist, wenn der Kontext nicht bekannt ist. Zum Beispiel:
QString up = i18nc("Go one directory up in the hierarchy", "Up");
QString relation = i18nc("A person's name and their familial relationship to you.", "%1 is your %2", name, relationship);
Kontext kann auch in Formularen, die mit dem Qt Designer erzeugt werden, hinzugefügt werden. Jedes Widget Label, einschließlich tooltips und whatsthis Texte haben ein "comment" Attribut, welches den gleichen Zweck wie das erste Argument von i18nc() hat.
Standard Kontext für häufige Ausdrücke
Es folgt eine Tabelle, die einige häufige Worte und Satzfragmente im Englischen und den entsprechend zu benutzenden Kontext, der benutzt werden muß, um die entsprechende Übersetzung in andere Sprachen zu bestimmen, auflistet.
| Satzfragment | Kontext | i18nc Call | Beispiel |
|---|---|---|---|
| Busy | Refering to a person | i18nc("A person is busy", "Busy") | |
| Busy | Refering to a thing | i18nc("A thing is busy", "Busy") | |
| Color | Color mode, as opposed to Grayscale | i18nc("Color mode", "Color") | |
| Creator | Refering to a person | i18nc("A person who creates", "Creator") | |
| Creator | Refering to software | i18nc("Software", "Creator") | |
| Display | Refering to hardware | i18nc("Hardware display", "Display") | |
| Editor | Refering to a person | i18nc("A person who edits", "Editor") | |
| Editor | Refering to software | i18nc("Software", "Editor") | |
| Line | Refering to drawing | i18nc("Draw a line", "Line") | |
| Line | Refering to text | i18nc("Line of text", "Line") | |
| Name | Refering to a name of thing | i18nc("A thing's name", "Name") | In theme change dialog: i18nc("Theme name", "Name") |
| Name | Refering to first name and last name of person | i18nc("Person's first and last name", "Name") | In KAddessbook contact edit dialog: i18nc("Person's first and last name", "Name") |
| No | Answer to a question | i18nc("Answer to a question", "No") | |
| No | Availability of a thing | i18nc("Availability", "No") | |
| (Re)load | (Re)load a document, medium etc. | i18nc("(Re)load a document", "(Re)load") | |
| (Re)load | (Re)start a program, daemon etc. | i18nc("(Re)start a program", "(Re)load") | |
| Title | Refering to a person | i18nc("A person's title", "Title") | |
| Title | Refering to a thing | i18nc("A thing's title", "Title") | |
| Volume | Refering to sound | i18nc("Sound volume", "Volume") | |
| Volume | Refering to a filesystem | i18nc("Filesystem volume", "Volume") | |
| Volume | Refering to books | i18nc("Book volume", "Volume") | |
| Yes | Answer to a question | i18nc("Answer to a question", "Yes") | |
| Yes | Availability of a thing | i18nc("Availability", "Yes") |
Plural
Plural wird von Sprache zu Sprache unterschiedlich behandelt. Viele Sprachen haben einen unterschiedlichen Plural für 2, 10, 20, 100 usw. Wennn die Zeichenkette, die übersetzt werden soll sich auf mehr als ein Item beziehen kann, müssen Sie eine dritte Form von i18n benutzen, nämlich i18np(). Die Funktion übernimmt die Singular- und Pluralversion in Englisch als erste beide Argumebnte, gefolgt von beliebigen Argumenten, die ersetzt werden sollen. Davon muß jedoch mindestens eines eine Ganzzahl sein. Beispiel:
msgStr = i18np("1 image in album %2", "%1 images in album %2", numImages, albumName);
msgStr = i18np("Delete Group", "Delete Groups", numGroups);i18np() wird enstrechend der in der Sprache des Benutzers notwenidigen Fälle erweitert. Im Englischen gibt es nur diese beiden Formen, während in anderen Sprachen mehrere existieren können, abhängig vom ersten Ganzzahlargument.
Beachten Sie, dass diese Form auch dann benutzt werden sollte, wenn die Zeichenkeitte sich immer auf mehrere Items bezieht, da manche Sprachen auch in anderen Fällen Singular (typischerweise bei 21, 32, etc.) benutzen. Dieser Code:
i18n("%1 files were deleted", numFilesDeleted);ist daher falsch und sollte lauten:
i18np("1 file was deleted",
"%1 files were deleted",
numFilesDeleted);Um neben Pluralangaben auch einen Kontext zu übergeben, benutzen Sie i18ncp wie in diesem Beispiel:
i18ncp("Personal file", "1 file", "%1 files", numFiles);Datum und Zahlen formatieren
When dem Benutzer Zahlen angezeigt werden, muss Ihr Programm die richtigen Dezimaltrennzeichen, Tausendertrennzeichen und Währungssymbole (falls überhaupt) darstellen. Diese Symbole unterschieden sich von Region zu Region. In englischsprachigen Ländern wird ein Punkt (.) benutzt um den gebrochenen Teil einer Zahl anzuzeigen (z.B. 12.5), während einige europäische Länder ein Komma (,) benutzen (z.B. 12,5). Es folgt eine Tabelle, die die Funktionen zusammenfasst, die Ihnen dabei hilft, diese lokalen Konventionen korrekt zu behandeln.
| Formatiert ein(e).. | Von einem.. | Funktions Prototyp |
|---|---|---|
| Zahl | String | QString formatNumber( const QString & numStr ) |
| Zahl | Integer, double | formatNumber( double num,
int precision = -1 )
|
| Währung | String | formatMoney( const QString & numStr ) |
| Währung | Zahl | formatMoney( double num,
const QString & currency,
int digits = -1 )
|
| Datum | String | formatDate( const QDate & pDate,
bool shortFormat=false )
|
| Uhrzeit | QTime | formatTime( const QTime & pTime,
bool includeSecs=false)
|
| Datum und Uhrzeit | QDateTime | formatDateTime( const QDateTime &pDateTime,
bool shortFormat = true,
bool includeSecs = false )
|
Ähnliche Funktionen existieren um Informationen zu lesen, die der Benutzer zur Laufzeit in seinem lokalisierten Format eingibt, z.B. readNumber() oder readMoney().
Kalender
Applikationen zu entwickeln, die sich mit Datum und Zeit beschäftigen, zum Beispiel Kalender, ist ein sehr komplexes Gebiet. Nicht nur Zeichenketten die ein Datum oder eine Uhrzeit beinhalten müssen lokal angepasst werden, man muss auch andere Aspekte bedenken, wie zum Beispiel:
- Welcher Tag in der Woche der erste ist (cf int weekStartDay())
- Wieviele Monate in einem Jahr sind
- "Ära"-basierte Kalender
- Ob ein 24-Stunden Zeitformat benutzt wird (cf bool use12Clock())
KLocale stellt neben anderen diese Methoden zur verfügung:
| Formatiert ein(e).. | von einem.. | Funktions Prototyp |
|---|---|---|
| Datum | QDate | formatDate( const QDate & pDate,
bool shortFormat=false )
|
| Uhrzeit | QTime | formatTime( const QTime & pTime,
bool includeSecs=false )
|
| Datum und Uhrzeit | QDateTime | formatDateTime( const QDateTime &pDateTime,
bool shortFormat=true,
bool includeSecs=false )
|
Dieser Abschnitt muss verbessert werden: Bitte hilf mit, verwirrende Abschnitte zu bereinigen und Abschnitte zu reparieren die ein todo beinhalten
Mehr Informationen für verschiedene Kalendersysteme geben
Häufige Fallen vermeiden
Es gibt eine Reihe von häufigen Problemen die es unmöglich machen, eine Applikation angemessen zu lokalisieren. Im nächsten Kapitel Häufige Fehler in der Lokalisation vermeiden lernen Sie mehr darüber und wie man solche Fehler vermeidet.