EmDash übersetzen

Die Administrationsoberfläche von EmDash ist mithilfe von Lingui für die Nachrichtenextraktion und Lunaria für die Verfolgung des Übersetzungsfortschritts übersetzbar. Alle Übersetzungen befinden sich in PO-Dateien (gettext) — eine pro Locale.

Übersetzungsstatus

Den aktuellen Fortschritt aller Locales sehen Sie im Übersetzungs-Dashboard.

Wer übersetzen kann

Übersetzungen müssen von Muttersprachlern oder fließend Sprechenden stammen. Wir akzeptieren keine maschinell generierten Übersetzungen. Wenn Sie KI-Tools zur Unterstützung verwenden, müssen Sie jeden String manuell überprüfen und das Ergebnis im Kontext testen (siehe Übersetzungen testen weiter unten).

Wir haben lieber keine Übersetzung für einen String als eine falsche. Eine falsche Übersetzung ist schlimmer als die Anzeige des englischen Fallbacks — sie führt Benutzer aktiv in die Irre.

Dateistruktur

Übersetzungskataloge befinden sich in packages/admin/src/locales/:

packages/admin/src/locales/
├── en/
│   └── messages.po    # English (source)
├── de/
│   └── messages.po    # German
└── ...

Jede .po-Datei enthält msgid/msgstr-Paare. Die msgid ist der englische Quelltext; die msgstr ist Ihre Übersetzung. Eine leere msgstr bedeutet „noch nicht übersetzt” — Lingui fällt zur Laufzeit auf Englisch zurück.

Strings übersetzen

Was übersetzt werden soll

• Der msgstr-Wert jedes Eintrags.

Was NICHT übersetzt werden soll

• msgid-Werte — das sind Suchschlüssel.
• Interpolationsplatzhalter wie {error}, {email}, {label} — lassen Sie diese unverändert.
• XML-ähnliche Tags wie <0>, </0> — diese umschließen interaktive Elemente (Links, Buttons). Behalten Sie die Tags bei und übersetzen Sie den Text dazwischen.
• Kommentare, die mit #: beginnen — das sind von Lingui hinzugefügte Quellreferenzen.

Interpolation und Tags

Einige Strings enthalten Platzhalter und Tags:

msgid "Authentication error: {error}"
msgstr "Authentifizierungsfehler: {error}"

msgid "Don't have an account? <0>Sign up</0>"
msgstr "Noch kein Konto? <0>Registrieren</0>"

msgid "If an account exists for <0>{email}</0>, we've sent a sign-in link."
msgstr "Falls ein Konto für <0>{email}</0> existiert, haben wir einen Anmeldelink gesendet."

Platzhalter ({error}, {email}) werden zur Laufzeit durch dynamische Werte ersetzt. Tags (<0>...</0>) umschließen React-Komponenten. Beide müssen in Ihrer Übersetzung exakt wie im Quelltext erscheinen — gleiche Namen, gleiche Verschachtelung.

Übersetzungen testen

Pseudo-Locale

EmDash enthält eine Pseudo-Locale, die alle umschlossenen Strings in akzentuierte Lookalikes umwandelt — "Dashboard" wird zu "Ðàšĥƀöàřð", und so weiter. Jeder String, der bei aktiver Pseudo-Locale in normalem Englisch erscheint, hat entweder keinen t..“-Wrapper oder stammt von außerhalb des Katalogs.

Um sie zu aktivieren, fügen Sie Folgendes zu Ihrer .env-Datei im Demo-Verzeichnis hinzu:

EMDASH_PSEUDO_LOCALE=1

Starten Sie dann den Entwicklungsserver neu. Die Pseudo-Locale erscheint als Pseudo in der Sprachauswahl auf der Anmeldeseite und in den Einstellungen. Wechseln Sie dorthin, um nicht umschlossene Strings auf einen Blick zu erkennen.

Eine neue Sprache hinzufügen

Wenn Ihre Sprache noch keine PO-Datei hat:

Übersetzungsstandards

Genauigkeit

Übersetzungen sollen den englischen Quelltext auf muttersprachlichem Niveau originalgetreu wiedergeben. Fügen Sie keine Bedeutung hinzu, entfernen Sie keine und interpretieren Sie keine um. Wenn ein Quellstring mehrdeutig ist, prüfen Sie den #:-Kommentar für den Speicherort der Quelldatei — lesen Sie den Komponentencode, um den Kontext zu verstehen.

Konsistenz

Verwenden Sie innerhalb Ihrer Locale eine einheitliche Terminologie. Wenn Sie „collection” an einer Stelle als „Sammlung” übersetzen, wechseln Sie anderswo nicht zu „Kollektion”. Wenn Ihre Sprache bereits Übersetzungen hat, lesen Sie die vorhandene PO-Datei durch, bevor Sie beginnen, um die etablierte Terminologie beizubehalten.

Tonfall

Die Administrationsoberfläche verwendet einen direkten, professionellen Ton. Passen Sie sich dem in Ihrer Sprache an — vermeiden Sie übermäßig formelle oder übermäßig lockere Formulierungen.

KI-gestützte Übersetzungen

Sie dürfen KI-Tools verwenden, um Übersetzungsentwürfe zu erstellen, aber:

• Sie müssen jeden String selbst überprüfen. KI-Tools machen subtile Fehler, die nur ein fließend Sprechender bemerkt — falsches Register, unnatürliche Formulierungen, falsche Fachbegriffe.
• Sie müssen das Ergebnis in der laufenden Administrationsoberfläche testen. KI-Tools kennen keine Layout-Beschränkungen oder UI-Kontext.
• Geben Sie die KI-Nutzung in Ihrer PR-Beschreibung an.
• PRs mit offensichtlich ungeprüften maschinellen Übersetzungen werden geschlossen.

Teilübersetzungen

Teilübersetzungen sind willkommen. Sie müssen nicht jeden String in einem PR übersetzen — jeder Fortschritt hilft. Nicht übersetzte Strings fallen zur Laufzeit auf Englisch zurück.