Zum Hauptinhalt springen
Das Frontend lädt nur die Übersetzungsschlüssel, die in services/web/frontend/extracted-translations.json aufgeführt sind (services/web/frontend/translations-loader.js). Das Backend und seine Templates lesen die vollständigen Dateien in services/web/locales/. Führen Sie dies im Verzeichnis develop einmal nach der ersten Einrichtung aus und erneut, nachdem Sie eine Übersetzung hinzugefügt oder den Branch gewechselt haben:
bin/i18n erledigt zwei Dinge:
  1. Es setzt services/web/locales/*.json auf die committeten Dateien zurück und wendet dann die Locale-Patches so an, wie es die Image-Builds tun: Die Dateien des höchsten Ordners locales_patches/v* ersetzen die Locales, und locales_patches/added/*.json werden Schlüssel für Schlüssel darübergelegt.
  2. Es führt yarn run extract-translations als Benutzer node im Container webpack aus, was extracted-translations.json neu schreibt. Fehlt das webpack-Image, synchronisiert es zuerst yarn.lock mit bin/sync und baut das Image.
Es benötigt jq auf dem Host.
Die Änderungen, die bin/i18n an services/web/locales/*.json vornimmt, sind nur lokal. Committen Sie sie nicht.
Verwenden Sie nach Möglichkeit einen vorhandenen Schlüssel. Die Locale-Dateien stammen aus dem Overleaf-Upstream oder von einer Übersetzungsplattform eines Drittanbieters, bearbeiten Sie sie daher nicht direkt. Ein neuer Schlüssel gehört nach services/web/locales/locales_patches/added/, und zwar in die Datei jeder Sprache gleichzeitig (en.json, zh-CN.json und die anderen).
Zuletzt geändert am 20. November 2026