Docs / Erste Schritte
Maschinell übersetzte Seite
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 --yesDetails: 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 --yesDetails: 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 --yesDetails: 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 --yesDetails: 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_ 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 --yesDetails: 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 --yesDetails: 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 --yesFü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 --yesDetails: 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_ geschrieben wird.
- Format:
gettext-po - Dateien:
locales/{locale}/LC_MESSAGES/messages.po
npx @verbatra/cli init --format gettext-po --provider gemini --yesDetails: gettext .po/.pot.
Java und Spring
Für .properties-Message-Bundles. init setzt außerdem localeStyle: "posix", damit pt-BR als messages_ geschrieben wird.
- Format:
properties - Dateien:
src/main/resources/messages_{locale}.properties
npx @verbatra/cli init --format properties --provider gemini --yesDetails: 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 --yesDetails: .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 --yesDetails: 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 --yesDetails: 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 --yesDetails: 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