files/de/archive/mozilla/xul/xul_tutorial/lokalisierung/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270

---
title: Lokalisierung
slug: Archive/Mozilla/XUL/XUL_Tutorial/Lokalisierung
tags:
  - Lokalisierung
  - XUL
  - XUL_Tutorial
translation_of: Archive/Mozilla/XUL/Tutorial/Localization
---
<p>{{ PreviousNext("XUL_Tutorial/Eine_eigene_Skin_erstellen", "XUL_Tutorial/Property-Dateien") }}</p>
<p>XUL und XML stellen Entities als komfortablen Weg bereit, um Lokalisierungen zu ermöglichen.</p>
<h3 id="Entities">Entities</h3>
<p>Viele Anwendungen sind so gebaut, dass das Interface so einfach wie möglich in verschiedene Sprachen zu übersetzten ist. Üblicherweise wird eine Tabelle aus Strings für jede Sprache erstellt. Anstelle von den Text direkt in die Applikation zu programmieren, stellt jede Textstelle nur eine Referenz zur Stringtabelle dar. <a href="/de/XML" title="de/XML">XML</a> stellt Entities zur Verfügung, welche für den gleichen Zweck verwendet werden können.</p>
<p>Man sollte mit Entities bereits vertraut sein, wenn man schon Erfahrungen mit <a href="/de/HTML" title="de/HTML">HTML</a> sammeln konnte. Der Code <code>&amp;lt;</code> und <code>&amp;gt;</code> sind Beispiele von Entities, welche anstelle von „Größer-als-“ und „Kleiner-als-Zeichen“ im Text verwendet werden können. XML besitzt einen Syntax, welcher dir das deklarieren eigener Entities erlaubt. Du kannst diese so verwenden, dass das Entity durch seinen Wert ersetzt wird, welcher ein Textstring ist. Entities können immer wenn Text auftritt verwendet werden, inklusive den Attributwerten. Das Beispiel unten demonstriert die Verwendung eines Entity in einem Button.</p>
<pre>&lt;button label="&amp;findLabel;"/&gt;
</pre>
<p>Der Text der als Label erscheinen wird, wird den Wert des Entity <code>&amp;findLabel;</code> sein. Eine Datei welche die Entity-Deklaration enthält wird für jede unterstützte Sprache erstellt. Für Englisch wird das <code>&amp;findLabel;</code> Entity wahrscheinlich mit dem Text »Find« deklariert sein.</p>
<h3 id="DTD-Dateien">DTD-Dateien</h3>
<p>Entities sind in <em>Document Type Declaration</em> (DTD) Dateien deklariert. Dateien dieses Typs werden normalerweise verwendet um den Syntax und die Semantik einer bestimmten XML-Datei zu deklarieren, aber es können auch Entities deklariert werden. Im Mozilla Chrome-System sind die DTD Dateien im <code>locales</code> Unterordner zu finden. Normalerweise existiert eine DTD Datei (mit der Endung <code>.dtd</code>) pro XUL-Datei.</p>
<p>Wenn man im Chrome-Ordner nachschaut, sollte man ein Archiv für die jeweilige Sprache (<code>de-De.jar</code> ist normalerweise Deutsch) finden. Es ist möglich lokale Dateien in verschiedenen Sprachen, z.B. Deutsch (de-DE) und Englisch (en-US) zu haben. Innerhalb dieser Archive sind die Dateien zu finden, welche den lokalisierten Text für jedes Fenster enthalten. Die Struktur der Archive ist sehr ähnlich derjenigen, die für Skins verwendet wird.</p>
<p>Im Innern der Archive würde man die DTD-Dateien platzieren in welchen die Entities deklariert werden sollen. Normalerweise wird für jede XUL-Datei eine DTD-Datei mit dem gleichen Namen erstellt mit allerdings einer <code>.dtd</code> Endung. Daher werden wir für den Dateisuchdialog eine Datei namens <code>findfile.dtd</code> benötigen.</p>
<p>Für nicht installierte chrome Dateien kann einfach die DTD-Datei ins selbe Verzeichnis wie die XUL-Datei ablegt werden.</p>
<div class="note"><strong>Anmerkung:</strong> Die DTD-Dateien sollten für nicht ASCII Zeichen als UTF-8 kodiert werden. Deswegen sollten die Dateien im UTF-8 Format gespeichert werden. (<a class="external" href="http://www.mozdev.org/notes/l10n/unicode/editors-en.html">ohne BOM</a>). Für mehr Informationen, siehe <a class="external" href="http://www.mozilla.org/projects/l10n/mlp_chrome.html#text">Mozilla Sprachpakete</a>.</div>
<p>Sobald eine DTD-Datei für das XUL erstellt worden ist, muss eine Zeile in die XUL-Datei einfügt werden, welche angibt, dass die DTD-Datei verwendet werden soll. Andernfalls werden Fehler auftreten, weil die Entities nicht gefunden werden. Um dies zu tun, muss die folgende Zeile irgendwo im oberen Bereich der XUL-Datei eingefügt werden:</p>
<pre>&lt;!DOCTYPE window SYSTEM "chrome://findfile/locale/findfile.dtd"&gt;
</pre>
<p>Diese Zeile legt fest, dass die URL auf eine DTD-Datei verweist. In diesem Fall wurde deklariert, dass die <code>findfile.dtd</code> DTD-Datei verwendet werden soll. Diese Zeile ist typischerweise gerade vor dem <code>window</code> Element platziert.</p>
<h3 id="Entities_deklarieren">Entities deklarieren</h3>
<p>Die Entities werden mit einem einfachen Syntax deklariert:</p>
<pre>&lt;!ENTITY findLabel "Find"&gt;
</pre>
<p>Dieses Beispiel erstellt ein Entity mit dem Namen <code>findLabel</code> und dem Wert »Find«. Dies bedeutet, dass überall wo der Text „&amp;findLabel;“ in der XUL-Datei auftritt es durch den Text »Find« ersetzt wird. Es sollte beachtet werden, dass die Deklaration kein Slash am Ende besitzt. In der DTD-Datei einer anderen Sprache wird der Text stattdessen in dieser Sprache geschrieben.</p>
<pre class="eval"><strong>für Japanisch:</strong>
&lt;!ENTITY findLabel "検索"&gt;
</pre>
<p>Zum Beispiel der folgende Text:</p>
<pre>&lt;description value="&amp;findLabel;"/&gt;
</pre>
<p>wird übersetzt als:</p>
<pre class="eval"><strong>Englische Version:</strong>
&lt;description value="Find"/&gt;

<strong>Japanische Version:</strong>
&lt;description value="検索"/&gt;
</pre>
<p>Es wird ein Entity für jede Beschriftung und Textstelle vorhanden sein, die dem Interface verwendet wird. Es sollte kein direkt angezeigter Text in den XUL-Dateien existieren.</p>
<p>Zusätzlich zu der Verwendung in Beschriftungen, sollten Entities für jeden Wert verwendet werden, welcher in einer anderen Sprache abweichen könnte. Access-Keys und Tastatur-Shortcuts zum Beispiel.</p>
<pre class="eval"> <strong>XUL</strong>
 &lt;menuitem label="&amp;undo.label;" accesskey="&amp;undo.key;"/&gt;
 <strong>DTD</strong>
 &lt;!ENTITY undo.label "Undo"&gt;
 &lt;!ENTITY undo.key "u"&gt;
</pre>
<p>Das Beispiel oben verwendet zwei Entities, eines für die Beschriftung des Menüpunktes und ein zweiter für den Access-Key.</p>
<p> </p>
<div class="highlight">
<h3 id=".C3.84nderung_des_Dateisuche_Beispiels" name=".C3.84nderung_des_Dateisuche_Beispiels">Änderung des Dateisuche Beispiels</h3>
<p>Werfen wir jetzt einen Blick darauf, wie wir das alles zusammenfügen können, indem wir den Dateisuche-Dialog so modifizieren, so dass eine DTD-Datei für alle seine Textstellen verwendet wird. Die gesamte XUL-Datei mit allen Änderungen in Rot ist unterhalb gezeigt.</p>
<pre class="eval">&lt;?xml version="1.0"?&gt;

&lt;?xml-stylesheet href="<a class=" external" rel="freelink">chrome://global/skin/</a>" type="text/css"?&gt;
&lt;?xml-stylesheet href="findfile.css" type="text/css"?&gt;

<span class="highlightred">&lt;!DOCTYPE window SYSTEM "<a class=" external" rel="freelink">chrome://findfile/locale/findfile.dtd</a>"&gt;</span>

&lt;window
  id="findfile-window"
  title="<span class="highlightred">&amp;findWindow.title;</span>"
  persist="screenX screenY width height"
  orient="horizontal"
  onload="initSearchList()"
  xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"&gt;

&lt;script src="findfile.js"/&gt;

&lt;popupset&gt;
   &lt;popup id="editpopup"&gt;
     &lt;menuitem label="Cut" accesskey="<span class="highlightred">&amp;cutCmd.accesskey;</span>"/&gt;
     &lt;menuitem label="Copy" accesskey="<span class="highlightred">&amp;copyCmd.accesskey;</span>"/&gt;
     &lt;menuitem label="Paste" accesskey="<span class="highlightred">&amp;pasteCmd.accesskey;</span>" disabled="true"/&gt;
   &lt;/popup&gt;
&lt;/popupset&gt;

&lt;keyset&gt;
   &lt;key id="cut_cmd" modifiers="accel" key="<span class="highlightred">&amp;cutCmd.commandkey;</span>"/&gt;
   &lt;key id="copy_cmd" modifiers="accel" key="<span class="highlightred">&amp;copyCmd.commandkey;</span>"/&gt;
   &lt;key id="paste_cmd" modifiers="accel" key="<span class="highlightred">&amp;pasteCmd.commandkey;</span>"/&gt;
   &lt;key id="close_cmd" keycode="VK_ESCAPE" oncommand="window.close();"/&gt;
&lt;/keyset&gt;

&lt;vbox flex="1"&gt;

 &lt;toolbox&gt;

  &lt;menubar id="findfiles-menubar"&gt;
    &lt;menu id="file-menu" label="<span class="highlightred">&amp;fileMenu.label;</span>"
        accesskey="<span class="highlightred">&amp;fileMenu.accesskey;</span>"&gt;
      &lt;menupopup id="file-popup"&gt;
        &lt;menuitem label="<span class="highlightred">&amp;openCmd.label;</span>"
                  accesskey="<span class="highlightred">&amp;openCmd.accesskey;</span>"/&gt;
        &lt;menuitem label="<span class="highlightred">&amp;saveCmd.label;</span>"
                  accesskey="<span class="highlightred">&amp;saveCmd.accesskey;</span>"/&gt;
        &lt;menuseparator/&gt;
        &lt;menuitem label="<span class="highlightred">&amp;closeCmd.label;</span>"
                  accesskey="<span class="highlightred">&amp;closeCmd.accesskey;" key="close_cmd" oncommand="window.close();</span>"/&gt;
      &lt;/menupopup&gt;
    &lt;/menu&gt;
    &lt;menu id="edit-menu" label="<span class="highlightred">&amp;editMenu.label;</span>"
          accesskey="<span class="highlightred">&amp;editMenu.accesskey;</span>"&gt;
      &lt;menupopup id="edit-popup"&gt;
        &lt;menuitem label="<span class="highlightred">&amp;cutCmd.label;</span>"
                  accesskey="<span class="highlightred">&amp;cutCmd.accesskey;</span>" key="cut_cmd"/&gt;
        &lt;menuitem label="<span class="highlightred">&amp;copyCmd.label;</span>"
                  accesskey="<span class="highlightred">&amp;copyCmd.accesskey;</span>" key="copy_cmd"/&gt;
        &lt;menuitem label="<span class="highlightred">&amp;pasteCmd.label;</span>"
                  accesskey="<span class="highlightred">&amp;pasteCmd.accesskey;</span>" key="paste_cmd" disabled="true"/&gt;
      &lt;/menupopup&gt;
    &lt;/menu&gt;
  &lt;/menubar&gt;

  &lt;toolbar id="findfiles-toolbar"&gt;
    &lt;toolbarbutton id="opensearch" label="<span class="highlightred">&amp;openCmdToolbar.label;</span>"/&gt;
    &lt;toolbarbutton id="savesearch" label="<span class="highlightred">&amp;saveCmdToolbar.label;</span>"/&gt;
  &lt;/toolbar&gt;
 &lt;/toolbox&gt;

 &lt;tabbox&gt;
  &lt;tabs&gt;
    &lt;tab label="<span class="highlightred">&amp;searchTab;</span>" selected="true"/&gt;
    &lt;tab label="<span class="highlightred">&amp;optionsTab;</span>"/&gt;
  &lt;/tabs&gt;

  &lt;tabpanels&gt;

   &lt;tabpanel id="searchpanel" orient="vertical" context="editpopup"&gt;

   &lt;description&gt;
     <span class="highlightred">&amp;findDescription;</span>
   &lt;/description&gt;

   &lt;spacer class="titlespace"/&gt;

   &lt;groupbox orient="horizontal"&gt;
     &lt;caption label="<span class="highlightred">&amp;findCriteria;</span>"/&gt;

     &lt;menulist id="searchtype"&gt;
       &lt;menupopup&gt;
         &lt;menuitem label="<span class="highlightred">&amp;type.name;</span>"/&gt;
         &lt;menuitem label="<span class="highlightred">&amp;type.size;</span>"/&gt;
         &lt;menuitem label="<span class="highlightred">&amp;type.date;</span>"/&gt;
       &lt;/menupopup&gt;
     &lt;/menulist&gt;
   &lt;spacer class="springspace"/&gt;
     &lt;menulist id="searchmode"&gt;
       &lt;menupopup&gt;
         &lt;menuitem label="<span class="highlightred">&amp;mode.is;</span>"/&gt;
         &lt;menuitem label="<span class="highlightred">&amp;mode.isnot;</span>"/&gt;
       &lt;/menupopup&gt;
     &lt;/menulist&gt;
   &lt;spacer class="springspace"/&gt;

   &lt;menulist id="find-text" flex="1"
             editable="true"
             datasources="<a class=" external" rel="freelink">file:///mozilla/recents.rdf</a>"
             ref="<span class="nowiki">http://www.xulplanet.com/rdf/recent/all</span>"&gt;
     &lt;template&gt;
       &lt;menupopup&gt;
         &lt;menuitem label="<span class="nowiki">rdf:http://www.xulplanet.com/rdf/recent#Label</span>" uri="rdf:*"/&gt;
       &lt;/menupopup&gt;
     &lt;/template&gt;
   &lt;/menulist&gt;

   &lt;/groupbox&gt;

  &lt;/tabpanel&gt;

  &lt;tabpanel id="optionspanel" orient="vertical"&gt;
     &lt;checkbox id="casecheck" label="<span class="highlightred">&amp;casesensitive;</span>"/&gt;
     &lt;checkbox id="wordscheck" label="<span class="highlightred">&amp;matchfilename;</span>"/&gt;
    &lt;/tabpanel&gt;

  &lt;/tabpanels&gt;
 &lt;/tabbox&gt;

 &lt;tree id="results" style="display: none;" flex="1"&gt;
   &lt;treecols&gt;
     &lt;treecol id="name" label="<span class="highlightred">&amp;results.filename;</span>" flex="1"/&gt;
     &lt;treecol id="location" label="<span class="highlightred">&amp;results.location;</span>" flex="2"/&gt;
     &lt;treecol id="size" label="<span class="highlightred">&amp;results.size;</span>" flex="1"/&gt;
   &lt;/treecols&gt;

   &lt;treechildren&gt;
     &lt;treeitem&gt;
       &lt;treerow&gt;
         &lt;treecell label="mozilla"/&gt;
         &lt;treecell label="/usr/local"/&gt;
         &lt;treecell label="<span class="highlightred">&amp;bytes.before;</span>2520<span class="highlightred">&amp;bytes.after;</span>"/&gt;
       &lt;/treerow&gt;
     &lt;/treeitem&gt;
   &lt;/treechildren&gt;
 &lt;/tree&gt;

 &lt;splitter id="splitbar" resizeafter="grow" style="display: none;"/&gt;

 &lt;spacer class="titlespace"/&gt;

 &lt;hbox&gt;
   &lt;progressmeter id="progmeter" value="50%" style="display: none;"/&gt;
   &lt;spacer flex="1"/&gt;
   &lt;button id="find-button" label="<span class="highlightred">&amp;button.find;</span>"
           oncommand="doFind()"/&gt;
   &lt;button id="cancel-button" label="<span class="highlightred">&amp;button.cancel;</span>"
           oncommand="window.close();"/&gt;
 &lt;/hbox&gt;
&lt;/vbox&gt;

&lt;/window&gt;
</pre>
<p>Jede Textstelle wurde durch eine Entity ersetzt. Eine DTD-Datei wurde nahe am Anfang eingefügt. Jede Entity welche eingefügt wurde, sollte in der DTD-Datei deklariert sein. Das Fenster wird nicht angezeigt, wenn eine Entity in der XUL-Datei gefunden wird, welche nicht deklariert wurde.</p>
<p>Es sollte beachtet werden, dass der Name der Entity nicht wichtig ist. Im Beispiel oben wurden die Wörter der Entities mit Bindestrichen getrennt. Dies ist keine Vorgabe. Die Entity-Namen folgen den selben Konventionen wie der Rest des Mozilla Codes.</p>
<p>Es ist vielleicht aufgefallen, dass der Text '2520 bytes' durch zwei Entities ersetzt wurde. Das kommt daher, weil die Struktur in anderen Sprachen variieren kann. Es könnte z.B. nötig sein, dass die Einheit vor der Zahl steht.</p>
<p>Die Access-Keys und Tastatur-Shortcuts wurden auch in Entities übersetzt, weil sie in anderen Sprachen abweichen können.</p>
<p>Nun die DTD-Datei - findfile.dtd:</p>
<pre>&lt;!ENTITY findWindow.title "Find Files"&gt;
&lt;!ENTITY fileMenu.label "File"&gt;
&lt;!ENTITY editMenu.label "Edit"&gt;
&lt;!ENTITY fileMenu.accesskey "f"&gt;
&lt;!ENTITY editMenu.accesskey "e"&gt;
&lt;!ENTITY openCmd.label "Open Search..."&gt;
&lt;!ENTITY saveCmd.label "Save Search..."&gt;
&lt;!ENTITY closeCmd.label "Close"&gt;
&lt;!ENTITY openCmd.accesskey "o"&gt;
&lt;!ENTITY saveCmd.accesskey "s"&gt;
&lt;!ENTITY closeCmd.accesskey "c"&gt;
&lt;!ENTITY cutCmd.label "Cut"&gt;
&lt;!ENTITY copyCmd.label "Copy"&gt;
&lt;!ENTITY pasteCmd.label "Paste"&gt;
&lt;!ENTITY cutCmd.accesskey "t"&gt;
&lt;!ENTITY copyCmd.accesskey "c"&gt;
&lt;!ENTITY pasteCmd.accesskey "p"&gt;
&lt;!ENTITY cutCmd.commandkey "X"&gt;
&lt;!ENTITY copyCmd.commandkey "C"&gt;
&lt;!ENTITY pasteCmd.commandkey "V"&gt;
&lt;!ENTITY openCmdToolbar.label "Open"&gt;
&lt;!ENTITY saveCmdToolbar.label "Save"&gt;
&lt;!ENTITY searchTab "Search"&gt;
&lt;!ENTITY optionsTab "Options"&gt;
&lt;!ENTITY findDescription "Enter your search criteria below and select the Find button to begin the search."&gt;
&lt;!ENTITY findCriteria "Search Criteria"&gt;
&lt;!ENTITY type.name "Name"&gt;
&lt;!ENTITY type.size "Size"&gt;
&lt;!ENTITY type.date "Date Modified"&gt;
&lt;!ENTITY mode.is "Is"&gt;
&lt;!ENTITY mode.isnot "Is Not"&gt;
&lt;!ENTITY casesensitive "Case Sensitive Search"&gt;
&lt;!ENTITY matchfilename "Match Entire Filename"&gt;
&lt;!ENTITY results.filename "Filename"&gt;
&lt;!ENTITY results.location "Location"&gt;
&lt;!ENTITY results.size "Size"&gt;
&lt;!ENTITY bytes.before ""&gt;
&lt;!ENTITY bytes.after "bytes"&gt;
&lt;!ENTITY button.find "Find"&gt;
&lt;!ENTITY button.cancel "Cancel"&gt;
</pre>
<p>Um den Text in einer neuen Sprache hinzuzufügen, genügt es eine weitere DTD-Datei zu erstellen. Durch die Verwendung des Chrome Systems, um die DTD-Datei einer anderen Sprache hinzuzufügen, kann die selbe XUL-Datei für jede Sprache verwendet werden.</p>
<p>Das Dateisuche Beispiel so weit: <a class=" external" href="http://developer.mozilla.org/samples/xultu/examples/findfile/findfile-locale.xul.txt">Quellcode</a></p>
</div>
<p>Als nächstes werden wir einen Blick auf <a href="/de/XUL_Tutorial/Property-Dateien">Property Dateien</a> werfen.</p>
<p>{{ PreviousNext("XUL_Tutorial/Eine_eigene_Skin_erstellen", "XUL_Tutorial/Property-Dateien") }}</p>
<p>{{ languages( { "en": "en/XUL_Tutorial/Localization", "fr": "fr/Tutoriel_XUL/Localisation", "ja": "ja/XUL_Tutorial/Localization", "pl": "pl/Kurs_XUL/Lokalizacja" } ) }}</p>