Übersetzungswellen: jede Sprache in den täglichen Gebrauch #

Das Ziel ist, dass jeder Mensch jeden Tag in seiner eigenen Sprache mit Exponential arbeiten kann, ohne je auf Englisch auszuweichen: in der Administration, in den Erweiterungen, die er benutzt, und in der Hilfe. Diese Seite misst, wo jede Sprache steht, und teilt die verbleibende Arbeit in Wellen. Eine Welle ist eine Sprache und ein Arbeitspaket, so klein, dass ein Übersetzer (ein Mensch oder ein Agent) sie in einem Zug beginnen und abschließen kann, jederzeit und unabhängig von jeder anderen Welle.

Die Zahlen und die Warteschlange unten werden aus den Dateien dieser Version erzeugt; der Rest der Seite erklärt, wie eine Welle gemacht und geprüft wird. Die Sprachen, ihre Locales und ihre Übersetzungen der Administration beschreibt Sprachen in Exponential.

Inhalt #

1. Der Plan, gemessen: wo jede Sprache steht, die Hilfe in Stufen, Sprachen ohne Übersetzung, die Warteschlange
2. Was die Wellen sind
3. Die Reihenfolge der Wellen
4. Vor einer Welle: die Voraussetzungen
5. Wie jede Art von Welle gemacht wird
6. Die Prüfungen nach jeder Welle
7. Fallen
8. Fertig: täglicher Gebrauch und Ziel
9. Sprecher und Schwierigkeit
10. Diese Seite aktuell halten

Der Plan, gemessen #

Gemessen am 5. November 2026 mit ./console exp:i18n waves aus den Dateien dieser Version (ohne Datenbank):

Wo jede Sprache steht #

Prozent der Texte (Administration, Erweiterungen) und der Wörter (Hilfe), abgerundet. Fett: unter 97 %. „Hilfe des Alltags“ sind die Teile für Redakteure, Benutzer und Administratoren (Stufen).

Die Hilfe in Stufen #

Sprachen ohne Übersetzung #

Die Sprachen der mitgelieferten Locales, die die Administration auf Englisch zeigt, die Sprachen, die auf einem Branch übersetzt werden, und Sprachen mit fünf Millionen Sprechern oder mehr, für die es noch keine Locale gibt (der Code ist ein Vorschlag). Sortiert nach Sprechern je Schwierigkeitspunkt.

Die Warteschlange: die ersten 60 Wellen #

Die ganze Warteschlange und die Seiten einer Welle: ./console exp:i18n waves --list, ./console exp:i18n waves --wave=<Welle>.

Erzeugt mit ./console exp:i18n waves; ./console exp:i18n waves --check und der Test expI18nTranslationWavesTest schlagen fehl, sobald ein Prozentwert nicht mehr stimmt oder ein Umfang um mehr als 3 % abweicht.

Was die Wellen sind #

Ein Arbeitspaket ist ein Stück Text des Produkts, das als Ganzes übersetzt wird:

Eine Welle ist ein Arbeitspaket für eine Sprache, benannt <Locale>/<Arbeitspaket>: ara-SA/H-help-manual-01 ist der erste Teil des Benutzerhandbuchs auf Arabisch. Der Befehl zeigt, was eine Welle umfasst und was davon fertig ist:

./console exp:i18n waves --wave=ara-SA/H-help-manual-01    # die Seiten, + fertig, - offen
./console exp:i18n waves --wave=A03                         # die Kontexte von Teil A03
./console exp:i18n waves --list                             # die ganze Warteschlange

Die Hilfe in Stufen. Die Abschnitte der Hilfe sind danach gruppiert, wer sie jeden Tag braucht:

• Alltag: die Seiten des Hilfecenters (help/*.md: erste Schritte, Anmelden, Inhalte bearbeiten, Medien, Suchen, Tastenkürzel), das Benutzerhandbuch (help/manual/), die Leitfäden in einfacher Sprache (help/non-technical-people/), die Anleitungen für Administratoren (guides/) und die beiden Lernbücher (help/book-learning/, help/book-building-a-site/). Sie kommen in jeder Sprache zuerst.
• Produkt- und Zielgruppen-Leitfäden: Installation, die Beschreibungen der Funktionen und die Leitfäden für jede Zielgruppe des Hilfecenters (Verwaltung, Unternehmen, Trainer, Designer, Hosting und die übrigen).
• Entwicklerreferenz: Erweiterungsentwicklung, Template-Sprache und Operatoren, Rückwärtskompatibilität, Standards, Spezifikationen, Geschichte und die handgeschriebenen Beispiele.
• Tabellen der erzeugten Beispiele: die mehr als zweitausend Referenzseiten werden aus dem Code erzeugt (exp:help:examples); eine Sprache übersetzt ihre Tabellen, nicht die Seiten (siehe die Beispiele).

Die Reihenfolge der Wellen #

Die Warteschlange wird berechnet, nicht von Hand gewählt. Sie läuft in acht Phasen; innerhalb einer Phase kommt eine Sprache mit mehr Sprechern je Schwierigkeitspunkt zuerst:

1. Die Kataloge der Prioritätsgruppe unter 100 %: die Teile der Administration und die mitgelieferten Erweiterungen von Deutsch, Arabisch, Türkisch, Ukrainisch, Russisch, Persisch, Paschtu und Kurdisch (Kurmandschi), und der Dari-Katalog (fas-AF, siehe abgeleitete Kataloge).
2. Deutsch: die Hilfe des Alltags, soweit sie noch nicht übersetzt ist (Deutsch hat fast die ganze Hilfe).
3. Die Hilfe des Alltags der Prioritätsgruppe: zuerst die Einrichtung der Hilfe jeder Sprache (S), dann Teil für Teil, eine Sprache nach der anderen: jede Sprache bekommt die ersten Schritte, bevor eine Sprache das Handbuch bekommt. Die Reihenfolge ist Arabisch (das auch den syrischen Kindern dient), Türkisch, Ukrainisch, Russisch, Persisch, Paschtu, Kurdisch.
4. Neue Übersetzungen der Administration: die Prüfung der abgeleiteten Kataloge, Nordkoreanisch, dann jede Sprache ohne Übersetzung, darunter die Sprachen mit fünf Millionen Sprechern oder mehr ohne Locale (ihre Locale zuerst, Welle L). Die Sprachen, die auf einem Branch übersetzt werden, warten, bis er zusammengeführt ist.
5. Die mitgelieferten Erweiterungen jeder anderen Übersetzung unter 100 %.
6. Die Hilfe des Alltags jeder anderen Übersetzung, wie in Phase 3.
7. Die übrige Hilfe der Prioritätsgruppe: Leitfäden, Referenz und Tabellen, Deutsch zuerst.
8. Die übrige Hilfe jeder anderen Übersetzung.

Die Prioritätsgruppe sind die häufigsten Herkunftssprachen geflüchteter Kinder in Hamburg: Deutsch, Englisch, Arabisch (syrisches Arabisch liest Hocharabisch, ara-SA), Türkisch, Ukrainisch, Russisch, Persisch (Farsi fas-IR, Dari fas-AF), Paschtu und Kurdisch (Kurmandschi, kur-TR). Ihre Administration ist vollständig; es fehlen die Hilfe und einige Erweiterungen, daher kommt ihre Hilfe vor den neuen Sprachen.

Vor einer Welle: die Voraussetzungen #

Lesen Sie diese vor der ersten Welle einer Sprache, und wieder, wenn eine Welle etwas Neues berührt:

• share/translations/TRANSLATING.md: die Regeln, die alle Sprachen teilen (Platzhalter, Markup, Leerraum, was nicht übersetzt wird, Wörter, die ihren Kontext brauchen, die Formen der Oberfläche).
• Die GUIDE.md der Sprache neben ihrem Katalog (share/translations/<Code>/GUIDE.md): Register, Anrede, Schrift und Typografie und das Glossar, das für den Kernel, jede Erweiterung und die Hilfe verbindlich ist. Eine neue Sprache schreibt ihre GUIDE.md in ihrer ersten Welle (A01), vor dem ersten Text; ein Begriff ändert sich zuerst im Leitfaden. Die Hilfe benutzt dasselbe Glossar wie die Administration, sodass eine Schaltfläche auf einer Seite so heißt wie auf dem Bildschirm.
• Von rechts nach links (Arabisch, Persisch, Paschtu, Urdu, Hebräisch, Jiddisch, Sindhi, Uigurisch, Sorani, Dhivehi, Syrisch, N’Ko): die Locale hat TextDirection=rtl, und die Hilfe zeigt eine Sprache von rechts nach links, wenn ihr Code in expHelpLanguage::RTL_LANGUAGES steht (in Welle S prüfen; Syrisch und N’Ko stehen noch nicht darin). Siehe Sprachen, die von rechts nach links geschrieben werden.
• Schriften: die Administration benutzt die Systemschriften des Lesers; der PDF-Export der Hilfe bettet die Schrift aus exphelp.ini [PdfSettings] FontFiles[] ein (DejaVu Sans), die Lateinisch, Kyrillisch, Griechisch, Armenisch, Georgisch und Hebräisch zeichnet. Für jede andere Schrift fügt Welle S eine Schrift hinzu, die sie hat (eine Noto-Schrift), bevor die erste Seite exportiert wird; Schriften mit komplexer Formung (Arabisch, die indischen Schriften, Thai, Khmer, Birmanisch, Tibetisch) werden an einer gedruckten Seite geprüft, nicht nur am Bildschirm. Siehe Schriften, Fonts und Zeilenumbruch.
• Die Locale: eine Sprache braucht ihre share/locale/<Code>.ini, bevor ihr Katalog gewählt werden kann (Welle L, siehe Eine Locale hinzufügen).

Wie jede Art von Welle gemacht wird #

Jede Welle ist ein Branch mit einem Commit (oder wenigen), benannt nach der Welle (i18n-wave-ara-SA-H-help-manual-01), damit nicht zwei Übersetzer dieselbe Welle nehmen: sehen Sie zuerst die offenen Branches an. Beginnen Sie mit einem aktuellen main.

Teil der Administration (A01 bis A10) #

1. ./console exp:i18n waves --wave=A03 listet die Kontexte des Teils.
2. Eine neue Sprache: legen Sie share/translations/<Code>/ aus share/translations/untranslated/translation.ts an (das Attribut language von <TS> ändern), schreiben Sie die GUIDE.md in A01. Eine vorhandene: mit bin/linux/ezlupdate <Code> auffrischen (Abschnitt 8 der Sprachenseite).
3. Übersetzen Sie jede Nachricht der Kontexte des Teils: Text in <translation>, type="unfinished" entfernt. Jedes <source> bleibt genau, wie es ist, Byte für Byte (siehe Fallen).
4. Messen: php bin/php/ezchecktranslation.php <Code> --allow-root-user, und ./console exp:i18n waves --check nennt den Teil, wenn sich sein Prozentwert geändert hat.
5. Eine Sprache, die in jedem Teil 100 % erreicht, kommt auf die Liste von tests/tests/lib/ezi18n/expTranslationQualityTest.php und in die Einstellungen einer neuen Übersetzung (Abschnitt 8).

Mitgelieferte Erweiterungen (E) #

Die Kataloge von ezoe, ezjscore und expimageeditor (die Erweiterungen mit einem Katalog im Manifest des Kernels). Ein fehlender Katalog wird aus translations/untranslated/translation.ts der Erweiterung angelegt; dann wie oben, mit den Kontextnamen der Erweiterung. ezoe und ezjscore stehen auch im Qualitätstest.

Die Erweiterungen einer Installation (E1 bis E6) #

Die übrigen Erweiterungen erscheinen aus ihren eigenen Repositories, daher werden ihre Kataloge an einer Installation gemessen, nicht hier: ./console exp:i18n fallbacks --locale=<Code> listet die Abdeckung jeder Erweiterung. Auf der Referenzinstallation (38 Erweiterungen mit Katalogen, 9.060 Texte, gemessen am 26. Oktober 2026) hatten Kroatisch, Tschechisch, Dänisch, Niederländisch, Italienisch, Norwegisch, Polnisch, Portugiesisch (Brasilien), Schwedisch und Türkisch 98 % davon, Spanisch und Hebräisch 96 %, Deutsch, mexikanisches Spanisch, Latein und Klingonisch 94 %, jede andere Übersetzung zwischen 28 und 35 %, Jiddisch 5 %. Die Gruppen, in dieser Reihenfolge nach der Hilfe des Alltags einer Sprache:

Jede Gruppe ist ein Commit im Repository jeder Erweiterung und eine neue Version dieser Erweiterung, mit erhöhter Versionsnummer wie bei jeder Version einer Erweiterung.

Neue Locale (L) #

Eine Sprache ohne share/locale/<Code>.ini bekommt sie zuerst, wie Eine Locale hinzufügen beschreibt: aus CLDR erzeugt, wo CLDR die Sprache hat, sonst von Hand geschrieben und von einem Sprecher geprüft (die meisten afrikanischen Sprachen sowie Haitianisch und Guaraní haben im ICU des Generators keine CLDR-Daten, siehe Verbreitete Sprachen, die noch fehlen). Ihre Prüfung, expLocaleFilesTest, muss bestehen. Der Code in der Tabelle Sprachen ohne Übersetzung ist ein Vorschlag: nehmen Sie den ISO-639-2-Code, den die übrigen Locales benutzen, und das Land mit den meisten Lesern.

Abgeleitete Kataloge: Dari und Nordkoreanisch #

Zwei Sprachen stehen einem vollständigen Katalog so nahe, dass die erste Welle ihn kopiert und nur ändert, was abweicht. Welle L macht den Katalog sofort benutzbar; die Prüfwellen (A01 bis A10, als „prüfen“ markiert) lesen ihn Teil für Teil gegen das Glossar.

• Dari (fas-AF, das Persisch Afghanistans): die Locale gibt es, sie fällt auf iranisches Persisch (fas-IR) zurück. Welle L kopiert share/translations/fas-IR/ nach fas-AF/, schreibt in deren GUIDE.md die Begriffe, in denen Dari abweicht (Wortschatz, die in Afghanistan gebrauchten Namen der Sonnenmonate, der Name der Sprache, دری), wendet sie an und entfernt die Fallback-Zeile von fas-AF aus settings/i18n.ini. Ein Leser aus Afghanistan prüft das Ergebnis.
• Nordkoreanisch (kor-KP, Munhwaŏ, der Standard der Demokratischen Volksrepublik Korea): eine neue, aus kor-KR abgeleitete Locale. Die Unterschiede sind systematisch und gehören deshalb in die GUIDE.md, bevor sich ein Text ändert: keine Anlautregel (리용, 련결, 로동, wo der Süden 이용, 연결, 노동 schreibt); andere Getrennt- und Zusammenschreibung, Komposita zusammen; das Zwischen-ㅅ wird nicht geschrieben; Lehnwörter in der nördlichen Form oder ein eigenes Wort (콤퓨터, 프로그람, 화일, 차림표 für Computer, Programm, Datei, Menü); der Name der Sprache 조선말 und des Landes 조선민주주의인민공화국, nie die südlichen Namen; eine andere alphabetische Reihenfolge der Buchstaben, der die Sortierung der Locale folgen muss. Die Locale-Datei (share/locale/kor-KP.ini, ContentLanguage=ko-KP, der nordkoreanische Won) kommt aus CLDR. Ein Sprecher des nördlichen Standards prüft das Ergebnis.

Eine Sprache der Hilfe einrichten (S) #

1. Legen Sie das Verzeichnis doc/<Locale in Kleinbuchstaben>/ an (doc/ara-sa/) und tragen Sie es in exphelp.ini [DocLanguages] Directories[] und Names[] ein; der Name wird im Kontext kernel/exphelp der Kataloge übersetzt. Andere Locales der Sprache lesen es ohne Eintrag in Map[] (ara-EG liest doc/ara-sa/).
2. Behalten Sie die englischen Dateinamen: eine Seite unter demselben relativen Pfad braucht keine .paths.json. Übersetzte Dateinamen (wie im Deutschen) sind möglich, kosten aber jede spätere Welle einen Eintrag; in einer anderen als der lateinischen Schrift sind sie nicht zu empfehlen.
3. Prüfen Sie die Schreibrichtung (expHelpLanguage::RTL_LANGUAGES) und die PDF-Schrift, wie in den Voraussetzungen.
4. Ablauf und Einstellungen stehen in Übersetzte Dokumentation.

Teil der Hilfe (H-…) #

1. ./console exp:i18n waves --wave=<Locale>/<Teil> listet die Seiten des Teils, - für die noch offenen.
2. Kopieren Sie jede offene Seite aus doc/eng-us/ unter denselben Pfad im Verzeichnis der Sprache und übersetzen Sie sie: den Text, die Überschriften, die Linktexte und die Bildbeschreibungen. Die Schlüssel der Front Matter, Codeblöcke, Befehle, Einstellungen, Dateinamen und in Code geschriebene Anker bleiben, wie sie sind; das summary: wird übersetzt. Links behalten ihre Ziele: ein Link auf eine noch nicht übersetzte Seite zeigt die englische Seite.
3. Benutzen Sie das Glossar: eine Schaltfläche, ein Menü oder eine Einstellung heißt auf der Seite so, wie die Administration sie in dieser Sprache nennt.
4. Committen Sie nur die Seiten des Teils: die Hilfe zeigt nur Seiten, die git verfolgt.

Tabellen der erzeugten Beispiele (X…) #

Die Referenzseiten erzeugt php bin/php/exphelpexamples.php aus Tabellen in doc/<Sprache>/.examples/ (strings.json und descriptions/*.json). Eine Welle übersetzt die Einträge ihrer Dateien: ./console exp:help:examples --language=<Verzeichnis> --worklist=var/tmp/todo.json schreibt die offenen, danach erzeugt der Befehl die Seiten, und --check muss bestehen. Das Verfahren beschreiben die Beispiele.

Die Prüfungen nach jeder Welle #

# die Regeln der Kataloge (Platzhalter, Markup, Leerraum, nicht leer, nicht Englisch)
vendor/bin/phpunit --no-coverage tests/tests/lib/ezi18n/expTranslationQualityTest.php
# der fertige Anteil eines Katalogs
php bin/php/ezchecktranslation.php <Code> --allow-root-user
# die Links und Bilder der Hilfe, unterhalb des Abschnitts des Teils
./console exp:help check --below=<Abschnitt>/
# die erzeugten Beispiele sind aktuell
php bin/php/exphelpexamples.php --check --allow-root-user
# diese Seite: die gezeigten Prozentwerte sind die gemessenen
./console exp:i18n waves --check
# das Manifest der mitgelieferten Dateien, vor jedem Commit
php bin/php/checkmanifest.php --fix

Lesen Sie danach das Ergebnis im laufenden Produkt: die Administration mit einer Benutzereinstellung oder einem Siteaccess Locale=<Code> nach dem Leeren des Übersetzungscaches (php bin/php/ezcache.php --clear-tag=i18n --allow-root-user), und die übersetzten Seiten im Hilfecenter in dieser Sprache. Nach einer Welle führen Sie ./console exp:i18n waves aus und committen die aktualisierte Seite mit der Welle, damit die Warteschlange die nächste zeigt.

Fallen #

• Eine Quelle mit einem Qt-Byte-Element. Ein Quelltext des Administrationskatalogs enthält einen als <byte value="x19"/> gespeicherten Apostroph in <source>. Kopieren Sie jedes <source>-Element unverändert, tippen oder „reparieren“ Sie es nie neu: der Übersetzer findet eine Nachricht an ihrer genauen Quelle, und eine geänderte Quelle ist eine neue, unübersetzte Nachricht.
• PHP und Python zählen verschieden. Ein Python-Skript, das <source> mit .text von ElementTree liest, bricht an diesem Byte-Element ab, und eines, das type="vanished" oder leere Übersetzungen nicht überspringt, zählt sie als fertig. Die Zahlen dieser Seite, der Sprachenseite und der Sprachumschaltung der Oberfläche kommen vom PHP-Leser (expUISwitchLanguageCatalogue::messageKeys(): Kontext, Quelle und Kommentar; unfertige, veraltete und leere Übersetzungen nicht gezählt; Prozente abgerundet). Weichen zwei Zählungen ab, hat die PHP-Zählung recht.
• Ein Worktree mit verlinktem vendor-Verzeichnis. In einem git-Worktree, dessen vendor/ ein symbolischer Link auf einen anderen Checkout ist, lädt der Autoloader von Composer die Kernel-Klassen jenes Checkouts, sodass die Tests den anderen Code testen und trotzdem bestehen. Geben Sie dem Worktree ein eigenes vendor/composer/ und vendor/autoload.php (Kopien; die Pakete dürfen Links bleiben) und prüfen Sie, dass der Testlauf Tests und Assertions meldet, nicht „No tests executed“.
• Das Manifest. share/filelist.md5 listet jede mitgelieferte Datei mit ihrer Prüfsumme; die Aktualisierungsprüfung meldet jede Datei, die davon abweicht. Führen Sie vor jedem Commit, nach der letzten Änderung, php bin/php/checkmanifest.php --fix aus.
• Platzhalter und Markup. %1, %name, <b>,   bleiben genau so; an einen Platzhalter wird nichts angehängt (TRANSLATING.md, Regel 1). Der Qualitätstest fängt das meiste davon, nicht alles.
• Der Übersetzungscache. Ein geänderter Katalog zeigt sich erst nach php bin/php/ezcache.php --clear-tag=i18n.
• Übersetzte Dateinamen in der Hilfe brauchen einen Eintrag in .paths.json; zwei Übersetzer, die beide Einträge hinzufügen, führen sie mit ./console exp:help maps --language=<Verzeichnis> --fix zusammen.
• Der erzeugte Teil dieser Seite wird nie von Hand bearbeitet; ./console exp:i18n waves schreibt ihn.

Fertig: täglicher Gebrauch und Ziel #

• Eine Welle ist fertig, wenn ihr Arbeitspaket in dieser Sprache bei 100 % steht, die Prüfungen oben bestehen und das Ergebnis im laufenden Produkt gelesen wurde.
• Eine Sprache ist im täglichen Gebrauch, wenn ihre Administration, ihre Erweiterungen und ihre Hilfe des Alltags je mindestens 97 % erreichen: was übrig bleibt, ist so selten, dass ein Leser an einem normalen Arbeitstag nicht auf Englisch trifft.
• Das Ziel sind 100 % in jedem Arbeitspaket, die ganze Hilfe eingeschlossen.

Sprecher und Schwierigkeit #

Die Sprecherzahlen sind Sprecher insgesamt, Erst- und Zweitsprache, in Millionen, gerundet, nach Ethnologue, wie Wikipedias „List of languages by total number of speakers“ und die Artikel der Sprachen sie angeben (Stand 2025). Sie ordnen die Warteschlange; sie sind keine Volkszählung, und eine bessere Zahl ist als Änderung von expI18nTranslationWaves::LANGUAGES willkommen.

Die Schwierigkeit (1 bis 5) einer Sprache ist 1, plus 1 für eine andere als die lateinische Schrift (2 für eine Schrift mit komplexer Formung oder ohne Leerzeichen zwischen den Wörtern: die indischen Schriften, Thai, Laotisch, Khmer, Birmanisch, Tibetisch, Ol Chiki), plus 1 für rechts nach links, plus 1 für reiche Flexion oder Agglutination, plus 1 oder 2, wenn es in der Sprache wenig Software-Terminologie gibt, höchstens 5. Die Warteschlange ordnet nach Sprechern je Schwierigkeitspunkt.

Sprachen, die in einem anderen Standard geschrieben werden, werden von ihm bedient und bekommen keine eigenen Wellen: Schweizerdeutsch und Bairisch (Deutsch), Neapolitanisch und Sizilianisch (Italienisch), die gesprochenen Varietäten des Arabischen (Hocharabisch), Kantonesisch und Wu (geschriebenes Chinesisch), die Regionalsprachen Indiens, die auf Hindi oder Bengalisch geschrieben werden.

Diese Seite aktuell halten #

./console exp:i18n waves misst neu und schreibt den erzeugten Teil dieser Seite und ihres englischen Originals; das Datum bleibt, solange sich nichts ändert. Diese Seite selbst zählt nicht zu den Seiten der Hilfe. ./console exp:i18n waves --check und der Test tests/tests/kernel/classes/i18n/expI18nTranslationWavesTest.php (ohne Datenbank) schlagen fehl, wenn sich ein Prozentwert einer Sprache geändert hat, eine Sprache ohne Übersetzung hinzugekommen ist oder eine bekommen hat, oder ein Umfang mehr als 3 % vom gemessenen abweicht, sodass eine kleine Änderung an einer Hilfeseite nicht jede andere Änderung scheitern lässt, der Plan aber nicht veralten kann.