Getting translation strings right/de: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | - | ||
| 3 | - | ||
| 1 | + | Diese Seite enthält einige grundlegende Bemerkungen darüber, **wie man Übersetzungstrings richtig hinbekommt** vom Anfang an und aus der Sichtweise eines Originalautors (d.h. zumeist eines Programmierers). | |
| 4 | 2 | ||
| 5 | - | ||
| 3 | + | "Richtig hinbekommen" (To get it right) bedeutet in diesem Zusammenhang, dass die Übersetzungsstrings für eine leichtere nachfolgende Übersetzung richtig vorbereitet wurden, und dass die Originalversion an die grundlegenden Erfordernisse für ihren Einsatz angepasst wurde. | |
| 6 | 4 | ||
| 7 | - | ||
| 5 | + | Obwohl hier versucht wurde, so sprachneutral wie möglich zu bleiben, besteht de facto eine leichte Einseitigkeit zugunsten des Englischen. Es liegt in Ihrem Ermessen, Richtlinien zu erweitern oder diejenigen zu verwerfen, die nicht auf Ihre Situation passen. (Oder vielleicht fügen Sie sie auch an diese Seite an?) | |
| 8 | 6 | ||
| 9 | - | ||
| 7 | + | ## Contents | |
| 10 | 8 | ||
| 11 | - | ||
| 12 | - | ||
| 9 | + | * 1 Allgemeines | |
| 10 | + | * 2 Technische Fragen | |
| 11 | + | * 2.1 Ressourcenstrings und GNU gettext | |
| 12 | + | * 2.2 Ressourcenstrings in der IDE | |
| 13 | + | * 2.3 Ressourcenstrings in Ihrer Anwendung | |
| 14 | + | * 2.4 Die Funktion format() | |
| 15 | + | * 2.5 Konvertierung der Übersetzung in den richtigen Zeichensatz | |
| 16 | + | * 3 Aufs Englische bezogen | |
| 17 | + | * 4 Siehe Auch | |
| 13 | 18 | ||
| 14 | - | ||
| 19 | + | ### Allgemeines | |
| 15 | 20 | ||
| 16 | - | ||
| 21 | + | Um Probleme zu vermeiden, stellen Sie einfach sicher, dass zuallererst **die Originalstrings in Ordnung sind** \- dafür gibt es einige Gründe: | |
| 17 | 22 | ||
| 18 | - | ||
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 22 | - | ||
| 23 | + | * Die Originalstrings dienen normalerweise als Vorgabeübersetzung, und hinterlassen einen schlechten Eindruck für den Endbenutzer, der ungewollt die unübersetzten Vorgabestrings sieht. | |
| 24 | + | * Auch erschweren schlechte Originalstrings dem Übersetzer die Arbeit unnötig. Dieser ist ja für die Übertragung der ursprünglichen Informationen in eine andere Sprache verantwortlich. Erinnern Sie sich einfach an das Prinzip "Wo Müll hinein kommt, kommt auch nur Müll heraus", das hier perfekt zutrifft. | |
| 23 | 25 | ||
| 24 | - | ||
| 26 | + | Versuchen Sie deshalb, sicher zu stellen, dass **die Schreibweise korrekt ist** \- nehmen Sie ein Wörterbuch zur Hand, wenn Sie sich unsicher sind (z.B. [[1]](<http://www.pons.de/>)). | |
| 25 | 27 | ||
| 26 | - | ||
| 28 | + | Benutzen Sie verständliche und bekannte Phrasen für die Situation, die Sie beschreiben möchten, in einer **einheitlichen** Weise. Falls Sie unsicher sind, ob etwas geläufig ist, schauen Sie sich ähnliche Programme an und betrachten Sie deren Ausgaben. Auch die Literatur und Hilfedateien sind oft eine gute Quelle für die genauen Fachbegriffe oder -ausdrücke, oder Fragen des Stils. Bleiben Sie auch in der Auswahl der Phrasen einheitlich. Beispielsweise haben die Fragen | |
| 29 | + | ``` | |
| 30 | + | Delete the file? (Datei löschen?) | |
| 31 | + | Erase the file? (Datei beseitigen?) | |
| 32 | + | Remove the file? (Datei entfernen?) | |
| 33 | + | Wipe the file? (Datei säubern?) | |
| 34 | + | Zap the file? (Datei vernichten?) | |
| 35 | + | ``` | |
| 27 | 36 | ||
| 28 | - | ||
| 37 | + | alle fast die selbe Bedeutung. Wenn man sie aber - ohne ersichtlichen Grund - wahlweise einsetzt, interpretiert manch ein Leser verrückte Dinge hinein. Besonders anfällig für diesen Fehler sind Übersetzer, weil sie oft den genauen Kontext einer bestimmten Nachricht nicht kennen (z.B. Informationen über den Ursprung der Nachricht). Sie könnten einfache Wortvariationen als Hinweis auf bedeutende Unterschiede interpretieren, und geraten in Versuchung, unübliche (schlechte) Übersetzungen zu wählen. | |
| 29 | 38 | ||
| 30 | - | ||
| 39 | + | Besonders bei Fehlermeldungen an den Benutzer gilt: Beschreiben Sie **das Problem selbst** in passenden Worten. Das ist niemals der Zustand des Programms, der zur Fehlermeldung führte. Dieser ist nur für die Person nützlich, die den Fehler im Programm beseitigen soll, nicht für den Benutzer. Benutzer werden entweder einfach mit den Schultern zucken und den Fehler bestenfalls ignorieren. Oder aber sie wechseln im schlechtesten Fall zu einem anderen Programm, weil sie ohne eine genaue Problembeschreibung nicht das Problem lösen und mit ihrer Arbeit fortfahren können. All das nur, weil das Programm keine brauchbare Problembeschreibung lieferte. | |
| 31 | 40 | ||
| 32 | - | ||
| 41 | + | Nehmen Sie (leicht) **verständliche Beschreibungen**. Versuchen Sie nicht, Ihre Kunden mit Fremdwörtern oder technischen Begriffen zu beeindrucken, nur um ihnen zu sagen, dass ihre Arbeit nicht gespeichert werden konnte. | |
| 33 | 42 | ||
| 34 | - | ||
| 43 | + | Vermeiden Sie mehrfache Verneinungen innerhalb eines einzelnen Satzes. Diese sind fast immer schwerer zu lesen als ihre nicht-negierten Gegenstücke. Ein Beispiel wäre | |
| 44 | + | ``` | |
| 45 | + | Diese Komponente kann auf Non-TControls nicht abgelegt werden. | |
| 46 | + | ``` | |
| 35 | 47 | ||
| 36 | - | ||
| 48 | + | Hingegen ist die nicht-negierte Formulierung | |
| 49 | + | ``` | |
| 50 | + | Diese Komponente kann nur auf TControls abgelegt werden. | |
| 51 | + | ``` | |
| 37 | 52 | ||
| 38 | - | ||
| 53 | + | sicher leichter zu lesen und zu verstehen. | |
| 39 | 54 | ||
| 40 | 55 | ### Technische Fragen | |
| 41 | 56 | ||
| 42 | - | ||
| 57 | + | In diesem Abschnitt erhalten Sie einen kurzen Überblick über technische Fragen, eigentlich einen Überblick über die grundlegenden Möglichkeiten. Diese umfassen das Konstrukt 'resourcestring', GNU gettext() und die Funktion 'format()'. | |
| 43 | 58 | ||
| 44 | 59 | #### Ressourcenstrings und GNU gettext | |
| 45 | 60 | ||
| 46 | - | ||
| 61 | + | Free Pascal hat einige eingebaute Sprachkonstrukte für die Behandlung konstanter Zeichenketten. Es gibt einen Abschnitt einer Unit namens "resourcestring", die speziell für diesen Zweck eingeführt wurde. Siehe auch den entsprechenden Abschnitt des FPC-Handbuchs (prog.pdf, S. 89ff oder [hier](<http://www.freepascal.org/docs-html/prog/progch9.html#x184-1870009>)) für die Details. | |
| 47 | 62 | ||
| 48 | - | ||
| 63 | + | GNU gettext ist ein spezieller Satz von Werkzeugen, um Übersetzungen für Ihre Programme zu liefern. Siehe ebenfalls im FPC-Handbuch (prog.pdf, S. 91ff oder [hier](<http://www.freepascal.org/docs-html/prog/progse41.html#x210-2130009.4>)). | |
| 49 | 64 | ||
| 50 | - | ||
| 65 | + | _Anmerkung:_ GNU gettext hat eine konzeptuelle Macke, die es nicht erlaubt, einen einzelnen Originalstring an mehrere übersetzte Strings zuzuweisen, also Achtung. | |
| 51 | 66 | ||
| 52 | 67 | #### Ressourcenstrings in der IDE | |
| 53 | 68 | ||
| 54 | - | ||
| 69 | + | * Lazarus hat ein Werkzeug, um einfach aus Stringkonstanten Ressourcenstrings zu erzeugen. Siehe [[IDE Window: Make ResourceString/de|Ressourcenstrings erzeugen]] | |
| 55 | 70 | ||
| 56 | - | ||
| 71 | + | * Für jeden Ressourcenstring-Abschnitt erzeugt FPC eine .rst-Datei, aber es gibt keinen Editor für diese Dateien. Lazarus kann automatisch .po-Dateien aus den .rst-Dateien erzeugen. Es gibt eine Vielzahl von Werkzeugen zum Bearbeiten von .po-Dateien (z.B. kbabel unter Linux, PoEdit unter Windows). | |
| 57 | 72 | ||
| 58 | - | ||
| 73 | + | Um die Erzeugung der .po-Dateien für ein Package zu aktivieren, beachten Sie folgende Schritte: | |
| 74 | + | ``` | |
| 75 | + | * Erstellen Sie ein Unterverzeichnis namens 'languages' (oder 'locale', oder sonstwie). | |
| 76 | + | * Öffnen Sie das Package. Stellen Sie unter Einstellungen -> IDE Integration -> Verzeichnis der .po-Dateien das Verzeichnis _languages_ ein. | |
| 77 | + | ``` | |
| 59 | 78 | ||
| 60 | - | ||
| 61 | - | ||
| 79 | + | Wenn Sie das nächste Mal das Package kompilieren, erzeugt die IDE die .po-Dateien. Anmerkung: Die .rst-Dateien müssen zu den Package-Units gehören. Andernfalls ignoriert die IDE die fremden .rst-Dateien. | |
| 62 | 80 | ||
| 63 | - | ||
| 81 | + | Das funktioniert auch bei Projekten. Das Verzeichnis wird unter Projekt -> Projekteinstellungen -> IDE Integration -> Verzeichnis der .po-Dateien. | |
| 64 | 82 | ||
| 65 | - | ||
| 83 | + | * Um eine deutsche Übersetzung zu erzeugen: kopieren Sie die Datei 'unit1.po' nach 'unit1.de.po'. Verwenden Sie dann einen Texteditor oder einen .po-Editor, um alle Zeichenketten zu übersetzen. | |
| 66 | 84 | ||
| 67 | - | ||
| 85 | + | * Die IDE lädt automatisch die .po-Dateien für installierte Packages, falls sie existieren. Für Beispiele siehe: lazarus/components/projecttemplates/languages/. | |
| 68 | 86 | ||
| 69 | - | ||
| 87 | + | * ToDo: Implementierung und Dokumentation über das Aktualisieren der übersetzten .po-Dateien, wenn neue Ressourcenstrings angefügt werden. | |
| 70 | 88 | ||
| 71 | - | ||
| 89 | + | * ToDo: Implementierung und Dokumentation über das Einsammeln aller .po-Dateien von statisch gelinkten Packages. | |
| 72 | 90 | ||
| 73 | - | ||
| 91 | + | ||
| 74 | 92 | ||
| 75 | 93 | #### Ressourcenstrings in Ihrer Anwendung | |
| 76 | 94 | ||
| 77 | - | ||
| 78 | - | ||
| 79 | - | ||
| 95 | + | Sie können die .po-Dateien bei der Initialisierung laden, um die Ressourcenstrings zu übersetzen. Fügen Sie dies Ihrer .lpr-Datei hinzu: | |
| 96 | + | ``` | |
| 80 | 97 | ... | |
| 81 | - | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 89 | - | ||
| 90 | - | ||
| 91 | - | ||
| 92 | - | ||
| 93 | - | ||
| 94 | - | ||
| 95 | - | ||
| 96 | - | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 98 | + | uses | |
| 99 | + | ... | |
| 100 | + | Translations, LazUTF8; | |
| 101 | + | ||
| 102 | + | procedure TranslateLCL; | |
| 103 | + | var | |
| 104 | + | PODirectory, Lang, FallbackLang: String; | |
| 105 | + | begin | |
| 106 | + | PODirectory:='/path/to/lazarus/lcl/languages/'; | |
| 107 | + | Lang:=''; | |
| 108 | + | FallbackLang:=''; | |
| 109 | + | LazGetLanguageIDs(Lang,FallbackLang); // in der Unit LazUTF8 | |
| 110 | + | Translations.TranslateUnitResourceStrings('LCLStrConsts', | |
| 111 | + | PODirectory+'lclstrconsts.%s.po',Lang,FallbackLang); | |
| 112 | + | // ... fügen Sie hier einen Aufruf von TranslateUnitResourceStrings für jede .po-Datei hinzu ... | |
| 113 | + | end; | |
| 114 | + | ||
| 115 | + | begin | |
| 116 | + | TranslateLCL; | |
| 117 | + | Application.Initialize; | |
| 118 | + | Application.CreateForm(TForm1, Form1); | |
| 119 | + | Application.Run; | |
| 120 | + | end. | |
| 104 | 121 | ``` | |
| 105 | 122 | ||
| 106 | - | ||
| 123 | + | Anmerkung für Mac OS X: Die IDs der unterstützten Sprachen sollten in der Eigenschaftenliste des Anwendungspakets zum Schlüssel CFBundleLocalizations hinzugefügt werden, für ein Beispiel siehe lazarus.app/Contents/Info.plist. | |
| 107 | 124 | ||
| 108 | 125 | #### Die Funktion format() | |
| 109 | 126 | ||
| 110 | - | ||
| 111 | - | ||
| 112 | - | ||
| 113 | - | ||
| 114 | - | ||
| 127 | + | Um in Übersetzungen nicht nur völlig statische Zeichenketten einzusetzen, können Sie auch die Methode [format()](<http://lazarus-ccr.sourceforge.net/docs/rtl/sysutils/format.html> "doc:rtl/sysutils/format.html") aus der Unit 'sysutils' verwenden. Mit ihr können Sie Platzhalter innerhalb eines vorgegebenen Texts durch deren tatsächlichen Wert ersetzen, der als zweiter Parameter in einer Menge gegeben ist. Beispiel: | |
| 128 | + | ``` | |
| 129 | + | format('Morgen am %0:s wird es %1:s geben.', ['Sonntag', 'Sonnenschein']); | |
| 130 | + | ``` | |
| 115 | 131 | ||
| 116 | - | ||
| 132 | + | liefert | |
| 133 | + | ``` | |
| 134 | + | Morgen am Sonntag wird es Sonnenschein geben. | |
| 135 | + | ``` | |
| 117 | 136 | ||
| 118 | - | ||
| 137 | + | In diesem Fall steht %0:s als Platzhalter für das erste Argument (mit dem Index 0) aus der Wertemenge (Sonntag), und entsprechend %1:s für das zweite. Für eine exakte Definition der erlaubten Platzhalter und ihre Syntax siehe das FPC-Referenz-Handbuch. | |
| 119 | 138 | ||
| 120 | - | ||
| 139 | + | Einige Richtlinien für den Gebrauch der Funktion format() | |
| 121 | 140 | ||
| 122 | - | ||
| 141 | + | * Verwenden Sie indizierte Platzhalter in den Originalstrings, auch wenn diese optional sind. Dies gestattet dem Übersetzer, die Argumente einfach innerhalb des Satzes zu verschieben und erlaubt somit natürlichere Ausdrücke. Und manchmal ist das Verschieben von Satzteilen auch tatsächlich erforderlich, um in dieser Sprache richtige Sätze bilden zu können. | |
| 123 | 142 | ||
| 124 | - | ||
| 143 | + | * Stellen Sie niemals einen Satz aus mehr als einem String zusammen. Nehmen Sie immer die Methode format() aus der Unit 'sysutils', um während der Laufzeit den richtigen String mittels Platzhaltern zu konstruieren. Ein Übersetzer würde normalerweise den ganzen Satz gar nicht rekonstruieren können, deshalb gäbe es auch keine gute Übersetzung; bedenken Sie nur einmal, dass oft Hunderte von solchen Strings in einer einzelnen Übersetzungsdatenbank vorkommen... | |
| 125 | 144 | ||
| 126 | - | ||
| 145 | + | * Verwenden Sie zum Formatieren keine Leerzeichen. Bewegen Sie als erstes einfach Ihr Label an die passende Position. Es ergeben sich sonst Probleme beim Wechseln der Schriftart, und scheinbar überflüssige Leerzeichen laufen Gefahr, vom Übersetzer weggeputzt zu werden. | |
| 127 | 146 | ||
| 128 | - | ||
| 147 | + | ~~_Anmerkung:_ Da format() bestimmte Steuerzeichen (z.B. wie C's "\n", "\t", u.s.w.) nicht versteht und GNU gettext aus bestimmten Gründen das gewählte Übersetzungssystem (und die darauf basierenden Werkzeuge nicht fähig sind, solche Steuerzeichen zu interpretieren), ist es erforderlich, die Zeilenvorschübe programmatisch einzufügen.~~In der aktuellen Version von Lazarus werden "\n" und "\t" in übersetzten Zeichenketten durch newline und tab ersetzt. | |
| 129 | 148 | ||
| 130 | 149 | #### Konvertierung der Übersetzung in den richtigen Zeichensatz | |
| 131 | 150 | ||
| 132 | - | ||
| 133 | - | ||
| 134 | - | ||
| 135 | - | ||
| 136 | - | ||
| 137 | - | ||
| 138 | - | ||
| 151 | + | Zum Beispiel: wandeln Sie eine Datei von ISO-8859-1 zu UTF-8 um: | |
| 152 | + | ``` | |
| 153 | + | iconv --from-code=ISO-8859-1 --to-code=UTF-8 oldfile.po > newfile.po | |
| 154 | + | ``` | |
| 139 | 155 | ||
| 140 | - | ||
| 156 | + | Vergessen Sie nicht die Zeile | |
| 157 | + | ``` | |
| 158 | + | "Content-Type: text/plain; charset=ISO-8859-1\n" | |
| 159 | + | ``` | |
| 141 | 160 | ||
| 142 | - | ||
| 161 | + | zu ändern in | |
| 162 | + | ``` | |
| 163 | + | "Content-Type: text/plain; charset=UTF8\n" | |
| 164 | + | ``` | |
| 143 | 165 | ||
| 144 | 166 | ### Aufs Englische bezogen | |
| 145 | 167 | ||
| 146 | - | ||
| 147 | - | ||
| 148 | - | ||
| 168 | + | Dieser Abschnitt enthält Anmerkungen, die besonders dann Berechtigung haben, wenn Sie Englisch als Ausgangssprache für Übersetzungen benutzen. | |
| 149 | 169 | ||
| 150 | - | ||
| 170 | + | * Reservieren Sie dort, wo der Text ausgegeben wird, genug Platz: Englisch ist eine Sprache in der die Texte fast immer kürzer sind (was die Zeichenanzahl betrifft) als in den jeweiligen Übersetzungen. Planen Sie also voraus und reservieren Sie ausreichend Platz. Die Erfahrung zeigt, dass sehr kurze Strings, die nur wenige Zeichen lang sind, sich im Umfang ungefähr verdoppeln; dieser Unterschied nimmt ab, wenn die Zeichenketten länger sind. | |
| 151 | 171 | ||
| 152 | - | ||
| 172 | + | * Vermeiden Sie im Englischen Abkürzungen; neben der Tatsache, dass dadurch schon recht kurze Strings noch weiter gekürzt werden, entstehen auch ernste Probleme z.B. in Sprachen mit ideographischen Zeichen, wo diese Abkürzungen einfach überhaupt nicht existieren. | |
| 153 | 173 | ||
| 154 | - | ||
| 174 | + | * Weil dies oft ein Problem darstellt: Im Englischen sind Satzzeichen (Punkt, Komma, ...) ein Teil des vorherigen Wortes, oder bilden selbst eine Art Wort falls es kein vorhergehendes Wort gibt (im Fall einer Aufzählung). Besonders nach einem Strichpunkt sollte immer ein Leerzeichen folgen. | |
| 155 | 175 | ||
| 156 | - | ||
| 176 | + | ``` | |
| 177 | + | There was an error ! Please check file settings , compiler settings,... to fix this issue. | |
| 178 | + | ``` | |
| 157 | 179 | ||
| 158 | - | ||
| 180 | + | hat eine entsetzliche Interpunktion, sieht deshalb einfach schlecht aus und ist schwerer zu lesen als gewohnt. Bedenken Sie auch, dass übliche Algorithmen zum Zeilenumbruch die Zeilen an den Leerzeichen aufteilen, das würde in einem einzelnen Punkt am Zeilenanfang resultieren. | |
| 181 | + | ``` | |
| 182 | + | There was an error! Please check file settings, compiler settings, ... to fix this issue. | |
| 183 | + | ``` | |
| 159 | 184 | ||
| 160 | - | ||
| 185 | + | wäre wahrscheinlich in Ordnung aus der Sicht der Interpunktion. | |
| 161 | 186 | ||
| 162 | 187 | ### Siehe Auch | |
| 163 | 188 | ||
| 164 | - | ||
| 165 | - | ||
| 166 | - | ||
| 189 | + | * [[Translations / i18n / localizations for programs/de|Translations / i18n / localizations for programs]] | |
| 190 | + | * [[Lazarus Documentation/de|Lazarus Documentation - Übersetzung/Internationalisierung]] | |
| 191 | + | * [[Step-by-step instructions for creating multi-language applications]] | |
| 167 | 192 | ||
| 168 | 193 | --- | |
| 169 | - | ||
| 194 | + | *From the Free Pascal wiki, page "Getting translation strings right/de", as the Internet Archive kept it on 2023-06-04. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |