DispatchAtlasÜbersetzungen
Wie DispatchAtlas seine Dokumentation lokalisiert: die Locale-Kohorte, die aktuelle Abdeckung, die Maschinen-Seed-plus-Mensch-Review-Pipeline, und wie man eine Übersetzung beiträgt.
DispatchAtlas serviert seine Dokumentation in einer Kohorte von zwölf Locales. Englisch ist die Quelle; jedes andere Locale ist ein Übersetzungsziel. Diese Seite erklärt, was heute übersetzt ist, die Disziplin, die die Übersetzungsqualität regiert, und die Schritte, eine Übersetzung beizutragen.
Locale-Kohorte
Die Site registriert zwölf Locales — Englisch an der Site-Wurzel und elf präfixierte Übersetzungsziele:
| Locale | Code | Richtung |
|---|---|---|
| Englisch (Quelle) | en | links-nach-rechts |
| Mandarin (vereinfacht) | zh-cn | links-nach-rechts |
| Spanisch | es | links-nach-rechts |
| Portugiesisch (Brasilien) | pt-br | links-nach-rechts |
| Französisch | fr | links-nach-rechts |
| Deutsch | de | links-nach-rechts |
| Japanisch | ja | links-nach-rechts |
| Koreanisch | ko | links-nach-rechts |
| Russisch | ru | links-nach-rechts |
| Indonesisch | id | links-nach-rechts |
| Arabisch | ar | rechts-nach-links |
| Hindi | hi | links-nach-rechts |
Jede Seite deklariert ihr lang, Arabisch rendert zusätzlich rechts-nach-links, und
ein symmetrisches hreflang-Set plus ein x-default, das auf die englische Seite
zeigt, verknüpft die Kohorte für Suchmaschinen. Ein Locale, das eine gegebene Seite noch
nicht übersetzt hat, lässt den hreflang-Eintrag dieser Seite weg, statt ihn auf
Englisch zu zeigen, sodass die Abwesenheit präzise gemeldet wird.
Aktuelle Abdeckung
Das Interface-Chrom — Navigation, Steuerelemente, Suche, und Fußzeile — ist über alle zwölf Locales übersetzt. Dokumentationsseiten werden inkrementell übersetzt; eine Seite ohne Übersetzung im angeforderten Locale rendert die englische Quelle als Rückfall, sodass keine Route je gebrochen ist. Die Abdeckung wächst Seite-für-Seite unter der Review-Pipeline unten; der Sprachumschalter erreicht stets jede Seite mindestens in ihrer englischen Form.
Die Maschinen-Seed-plus-Mensch-Review-Pipeline
Übersetzungsqualität ist ein Release-Kriterium, kein nachträglicher Gedanke. Zwei Stufen regieren jede übersetzte Seite:
- Maschinen-Seed. Eine Seite wird zuerst per Maschinenübersetzung gegen das Pro-Locale-Glossar entworfen, das das Domänenvokabular (Planung, Dispatch, Benchmark, Solver, Ziel, Constraint) auf einen konsistenten Begriff pro Locale fixiert.
- Mensch-Review. Ein muttersprachlich-fließender Prüfer korrigiert den Seed auf Flüssigkeit, Terminologie, und Ton, bevor er ausgeliefert wird. Maschinen-geseedete Kopie wird niemals als finaler ungeprüfter Text veröffentlicht.
Eine Seite ist in einem Locale erst release-bereit, nachdem ein Prüfer sie attestiert hat. Bis dahin steht der englische Rückfall, der präzise und vollständig ist statt teilweise-übersetzt.
Eine Übersetzung beitragen
- Wähle eine Seite unter
site/content/docs/en/und das Ziel-Locale. - Erstelle den Spiegelpfad unter
site/content/docs/<locale>/mit demselben relativen Slug und denselben Frontmatter-Schlüsseln (title,description). - Übersetze den Körper, das Glossar des Locales ehrend, damit die Domänenbegriffe mit dem Rest dieses Locales konsistent bleiben.
- Halte jeden Codeblock, Befehl, Identifier, Linkziel, und jede Abbildungsreferenz identisch zur Quelle — nur natürlichsprachliche Prosa wird übersetzt.
- Eröffne einen Beitrag für muttersprachlich-fließende Review. Einmal attestiert, wird
die Seite in diesem Locale ausgeliefert und ihr
hreflang-Eintrag der Kohorte hinzugefügt.
Siehe den Beitragsleitfaden für den Repository-Workflow und den Review-Prozess, der für jede Änderung gilt.