Zum Inhalt springen

Docs / Erste Schritte

Maschinell übersetzte Seite

Diese Seite wurde automatisch übersetzt und kann daher Fehler oder seltsame Formulierungen enthalten. Die englische Version ist die maßgebliche Quelle. Das englische Original lesen.

Wähle deinen Stack

Finde dein Framework und kopiere die Format-ID und den init-Befehl, mit denen du verbatra dafür einrichtest, samt dem üblichen Layout der Locale-Dateien.

Such dir unten dein Framework heraus und nimm seinen init-Befehl statt des Befehls aus dem Schnellstart. Jedes Dateilayout ist das Muster, das init schreibt, wenn es keine Locale-Dateien findet; gibt es deine Dateien schon, erkennt init, wo sie liegen, und mit --path legst du das Muster selbst fest. Das vollständige Verhalten jedes Formats steht unter Formate. Für manche Stacks gibt es außerdem einen Schnellstart Schritt für Schritt, verlinkt am Ende ihres Abschnitts.

React mit i18next

Für Projekte mit i18next, react-i18next und next-i18next.

  • Format: i18next-json
  • Dateien: locales/{locale}.json
npx @verbatra/cli init --format i18next-json --provider gemini --yes

Details: Die vier JSON-Formate.

Schritt für Schritt: Schnellstart mit React.

Next.js mit next-intl

Für Nachrichtendateien von next-intl, deren Werte ICU-Nachrichten sind.

  • Format: next-intl-json
  • Dateien: messages/{locale}.json
npx @verbatra/cli init --format next-intl-json --provider gemini --yes

Details: Die vier JSON-Formate.

Schritt für Schritt: Schnellstart mit Next.js.

Vue und Nuxt mit vue-i18n

Für vue-i18n, auch in Nuxt I18n, mit Platzhaltern in einfachen geschweiften Klammern und Pluralformen mit senkrechtem Strich.

  • Format: vue-i18n-json
  • Dateien: src/locales/{locale}.json
npx @verbatra/cli init --format vue-i18n-json --provider gemini --yes

Details: Die vier JSON-Formate.

Schritt für Schritt: Schnellstart mit Vue.

Angular mit ngx-translate

Für ngx-translate-JSON, flach oder verschachtelt.

  • Format: ngx-translate-json
  • Dateien: src/assets/i18n/{locale}.json
npx @verbatra/cli init --format ngx-translate-json --provider gemini --yes

Details: Die vier JSON-Formate.

Schritt für Schritt: Schnellstart mit Angular.

Flutter

Für die Application Resource Bundles von Flutter. init setzt außerdem localeStyle: "posix", damit pt-BR als app_pt_BR.arb geschrieben wird, der Name, den flutter gen-l10n liest.

  • Format: arb
  • Dateien: lib/l10n/app_{locale}.arb
npx @verbatra/cli init --format arb --provider gemini --yes

Details: ARB.

Schritt für Schritt: Schnellstart mit Flutter.

Android

Für strings.xml-Ressourcen. init setzt außerdem localeStyle: "android", damit das Token für die Quelle zu values und für Deutsch zu values-de wird.

  • Format: android-xml
  • Dateien: app/src/main/res/{locale}/strings.xml
npx @verbatra/cli init --format android-xml --provider gemini --yes

Details: Android strings.xml.

iOS und macOS

Zwei Formate, je nachdem, wie dein Projekt seine Texte speichert. Für .strings-Dateien mit ihren .stringsdict-Pluralformen:

  • Format: apple-strings
  • Dateien: {locale}.lproj/Localizable.strings
npx @verbatra/cli init --format apple-strings --provider gemini --yes

Für einen Xcode String Catalog, eine einzige Datei für alle Locales. Leg den Katalog zuerst in Xcode an: verbatra schreibt hinein, legt ihn aber nie selbst an.

  • Format: apple-xcstrings
  • Dateien: {locale}Localizable.xcstrings

Das Muster braucht das Token {locale}, aber bei einem String Catalog wird es zu nichts: Jede Locale liest und schreibt die eine Datei Localizable.xcstrings.

npx @verbatra/cli init --format apple-xcstrings --provider gemini --yes

Details: Apple .strings und Xcode String Catalogs.

gettext

Für .po-Kataloge und ihre .pot-Vorlagen, wie sie Python-, PHP- und C-Projekte nutzen. init setzt außerdem localeStyle: "posix", damit pt-BR als pt_BR geschrieben wird.

  • Format: gettext-po
  • Dateien: locales/{locale}/LC_MESSAGES/messages.po
npx @verbatra/cli init --format gettext-po --provider gemini --yes

Details: gettext .po/.pot.

Java und Spring

Für .properties-Message-Bundles. init setzt außerdem localeStyle: "posix", damit pt-BR als messages_pt_BR.properties geschrieben wird.

  • Format: properties
  • Dateien: src/main/resources/messages_{locale}.properties
npx @verbatra/cli init --format properties --provider gemini --yes

Details: Properties.

.NET

Für .resx-Ressourcendateien. Bilder, Icons und Designer-Einträge bleiben unberührt.

  • Format: resx
  • Dateien: Resources/Strings.{locale}.resx
npx @verbatra/cli init --format resx --provider gemini --yes

Details: .NET .resx.

YAML

Für verschachtelte YAML-Locale-Dateien mit Platzhaltern im i18next-Stil, {{double-brace}}.

  • Format: yaml
  • Dateien: locales/{locale}.yml
npx @verbatra/cli init --format yaml --provider gemini --yes

Details: YAML.

XLIFF

Für XLIFF-1.2- und -2.0-Dokumente aus Angulars ng extract-i18n, einem CAT-Tool oder von einer Agentur.

  • Format: xliff
  • Dateien: locales/{locale}.xlf
npx @verbatra/cli init --format xliff --provider gemini --yes

Details: XLIFF.

INI

Für klassische INI-Dateien mit einer Ebene von [section]-Überschriften.

  • Format: ini
  • Dateien: locales/{locale}.ini
npx @verbatra/cli init --format ini --provider gemini --yes

Details: INI.

Etwas anderes

Ein Format, das verbatra nicht mitbringt, kannst du trotzdem übersetzen, über einen Adapter, den du selbst schreibst. Siehe Einen eigenen Format-Adapter schreiben.

Auf GitHub bearbeiten

Auf dieser Seite