Getting translation strings right/de: what changed

Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	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).
2	2
3	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.
4	4
5	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?)
6	6
7	7		### Allgemeines
8	8
9	9		Um Probleme zu vermeiden, stellen Sie einfach sicher, dass zuallererst die Originalstrings in Ordnung sind - dafür gibt es einige Gründe:
10	10
11	11		- Die Originalstrings dienen normalerweise als Vorgabeübersetzung, und hinterlassen einen schlechten Eindruck für den Endbenutzer, der ungewollt die unübersetzten Vorgabestrings sieht.
12	12		- 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.
13	13
14	14		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/)).
15	15
16	16		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
17	17
18		-	~~`Delete the file? (Datei löschen?)`\~~
19		-	~~`Erase the file? (Datei beseitigen?)`\~~
20		-	~~`Remove the file? (Datei entfernen?)`\~~
21		-	~~`Wipe the file? (Datei säubern?)`\~~
22		-	~~`Zap the file? (Datei vernichten?)`~~
	18	+	```text
	19	+	Delete the file? (Datei löschen?)
	20	+	Erase the file? (Datei beseitigen?)
	21	+	Remove the file? (Datei entfernen?)
	22	+	Wipe the file? (Datei säubern?)
	23	+	Zap the file? (Datei vernichten?)
	24	+	```
23	25
24	26		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.
25	27
26	28		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.
27	29
28	30		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.
29	31
30	32		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
31	33
32		-	~~`Diese Komponente kann auf Non-TControls nicht abgelegt werden.`~~
	34	+	```text
	35	+	Diese Komponente kann auf Non-TControls nicht abgelegt werden.
	36	+	```
33	37
34	38		Hingegen ist die nicht-negierte Formulierung
35	39
36		-	~~`Diese Komponente kann nur auf TControls abgelegt werden.`~~
	40	+	```text
	41	+	Diese Komponente kann nur auf TControls abgelegt werden.
	42	+	```
37	43
38	44		sicher leichter zu lesen und zu verstehen.
39	45
40	46		### Technische Fragen
41	47
42	48		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	49
44	50		#### Ressourcenstrings und GNU gettext
45	51
46	52		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	53
48	54		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	55
50	56		Anmerkung: GNU gettext hat eine konzeptuelle Macke, die es nicht erlaubt, einen einzelnen Originalstring an mehrere übersetzte Strings zuzuweisen, also Achtung.
51	57
52	58		#### Ressourcenstrings in der IDE
53	59
54	60		- Lazarus hat ein Werkzeug, um einfach aus Stringkonstanten Ressourcenstrings zu erzeugen. Siehe [[IDE Window: Make ResourceString/de\|Ressourcenstrings erzeugen]]
55	61
56	62		- 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	63
58	64		Um die Erzeugung der .po-Dateien für ein Package zu aktivieren, beachten Sie folgende Schritte:
59	65
60		-	~~` * Erstellen Sie ein Unterverzeichnis namens 'languages' (oder 'locale', oder sonstwie).`\~~
61		-	~~` * Öffnen Sie das Package. Stellen Sie unter Einstellungen -> IDE Integration -> Verzeichnis der .po-Dateien das Verzeichnis ``languages`` ein.`~~
	66	+	```text
	67	+	* Erstellen Sie ein Unterverzeichnis namens 'languages' (oder 'locale', oder sonstwie).
	68	+	* Öffnen Sie das Package. Stellen Sie unter Einstellungen -> IDE Integration -> Verzeichnis der .po-Dateien das Verzeichnis languages ein.
	69	+	```
62	70
63	71		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.
64	72
65	73		Das funktioniert auch bei Projekten. Das Verzeichnis wird unter Projekt -\> Projekteinstellungen -\> IDE Integration -\> Verzeichnis der .po-Dateien.
66	74
67	75		- 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.
68	76
69	77		- Die IDE lädt automatisch die .po-Dateien für installierte Packages, falls sie existieren. Für Beispiele siehe: lazarus/components/projecttemplates/languages/.
70	78
71	79		- ToDo: Implementierung und Dokumentation über das Aktualisieren der übersetzten .po-Dateien, wenn neue Ressourcenstrings angefügt werden.
72	80
73	81		- ToDo: Implementierung und Dokumentation über das Einsammeln aller .po-Dateien von statisch gelinkten Packages.
74	82
75	83		#### Ressourcenstrings in Ihrer Anwendung
76	84
77	85		Sie können die .po-Dateien bei der Initialisierung laden, um die Ressourcenstrings zu übersetzen. Fügen Sie dies Ihrer .lpr-Datei hinzu:
78	86
79	87		``` pascal
80	88		...
81	89		uses
82	90		...
83	91		Translations, LazUTF8;
84	92
85	93		procedure TranslateLCL;
86	94		var
87	95		PODirectory, Lang, FallbackLang: String;
88	96		begin
89	97		PODirectory:='/path/to/lazarus/lcl/languages/';
90	98		Lang:='';
91	99		FallbackLang:='';
92	100		LazGetLanguageIDs(Lang,FallbackLang); // in der Unit LazUTF8
93	101		Translations.TranslateUnitResourceStrings('LCLStrConsts',
94	102		PODirectory+'lclstrconsts.%s.po',Lang,FallbackLang);
95	103		// ... fügen Sie hier einen Aufruf von TranslateUnitResourceStrings für jede .po-Datei hinzu ...
96	104		end;
97	105
98	106		begin
99	107		TranslateLCL;
100	108		Application.Initialize;
101	109		Application.CreateForm(TForm1, Form1);
102	110		Application.Run;
103	111		end.
104	112		```
105	113
106	114		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	115
108	116		#### Die Funktion format()
109	117
110	118		Um in Übersetzungen nicht nur völlig statische Zeichenketten einzusetzen, können Sie auch die Methode [[doc:rtl/sysutils/format.html\|format()]] 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:
111	119
112		-	~~`format('Morgen am %0:s wird es %1:s geben.', ['Sonntag', 'Sonnenschein']);`~~
	120	+	```text
	121	+	format('Morgen am %0:s wird es %1:s geben.', ['Sonntag', 'Sonnenschein']);
	122	+	```
113	123
114	124		liefert
115	125
116		-	~~`Morgen am Sonntag wird es Sonnenschein geben.`~~
	126	+	```text
	127	+	Morgen am Sonntag wird es Sonnenschein geben.
	128	+	```
117	129
118	130		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	131
120	132		Einige Richtlinien für den Gebrauch der Funktion format()
121	133
122	134		- 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	135
124	136		- 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	137
126	138		- 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	139
128	140		~~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	141
130	142		#### Konvertierung der Übersetzung in den richtigen Zeichensatz
131	143
132	144		Zum Beispiel: wandeln Sie eine Datei von ISO-8859-1 zu UTF-8 um:
133	145
134		-	~~` iconv --from-code=ISO-8859-1 --to-code=UTF-8 oldfile.po > newfile.po`~~
	146	+	```text
	147	+	iconv --from-code=ISO-8859-1 --to-code=UTF-8 oldfile.po > newfile.po
	148	+	```
135	149
136	150		Vergessen Sie nicht die Zeile
137	151
138		-	~~` "Content-Type: text/plain; charset=ISO-8859-1\n"`~~
	152	+	``` pascal
	153	+	"Content-Type: text/plain; charset=ISO-8859-1\n"
	154	+	```
139	155
140	156		zu ändern in
141	157
142		-	~~` "Content-Type: text/plain; charset=UTF8\n"`~~
	158	+	``` pascal
	159	+	"Content-Type: text/plain; charset=UTF8\n"
	160	+	```
143	161
144	162		### Aufs Englische bezogen
145	163
146	164		Dieser Abschnitt enthält Anmerkungen, die besonders dann Berechtigung haben, wenn Sie Englisch als Ausgangssprache für Übersetzungen benutzen.
147	165
148	166		- 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.
149	167
150	168		- 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.
151	169
152	170		- 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.
153	171
154		-	~~`There was an error ! Please check file settings , compiler settings,... to fix this issue.`~~
	172	+	```text
	173	+	There was an error ! Please check file settings , compiler settings,... to fix this issue.
	174	+	```
155	175
156	176		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.
157	177
158		-	~~`There was an error! Please check file settings, compiler settings, ... to fix this issue.`~~
	178	+	```text
	179	+	There was an error! Please check file settings, compiler settings, ... to fix this issue.
	180	+	```
159	181
160	182		wäre wahrscheinlich in Ordnung aus der Sicht der Interpunktion.
161	183
162	184		### Siehe Auch
163	185
164	186		- [[Translations / i18n / localizations for programs/de\|Translations / i18n / localizations for programs]]
165	187		- [[Lazarus Documentation/de\|Lazarus Documentation - Übersetzung/Internationalisierung]]
166	188		- [[Step-by-step instructions for creating multi-language applications]]
167	189
168	190		---
169	191		From the Free Pascal wiki, page "Getting translation strings right/de", as it stood on 2020-02-16 after a change by Trev, out of the wiki's dump of 2024-05-26. 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).

Back to history