Skip to content

Konfigurationsreferenz ​

sourceLocale ​

BCP-47-Code für die Ausgangssprache (z. B. "en-GB", "pt-BR" oder "ja"). Jede Sprache ist gültig. Englisch erscheint in den Beispielen, da viele Projekte dort beginnen. Für dieses Gebietsschema wird keine Übersetzungsdatei generiert – der Schlüsselstring selbst ist der Quelltext.

Muss SOURCE_LOCALE entsprechen, der aus Ihrer Laufzeit-i18n-Konfigurationsdatei exportiert wird (src/i18n.ts / src/i18n.js).


targetLocales ​

Array mit BCP-47-Gebietsschemaschlüsseln, in die übersetzt werden soll (z. B. ["de", "fr", "es", "pt-BR"]).

targetLocales ist die primäre Gebietsschema-Liste für die UI-Übersetzung und die Standard-Gebietsschema-Liste für Dokumentationsblöcke. Verwenden Sie generate-ui-languages, um das ui-languages.json-Manifest aus sourceLocale + targetLocales zu erstellen.


uiLanguage (optional) ​

BCP-47-Code für die eigene UI-Sprache des Tools (CLI-Hilfe, Protokolle/Zusammenfassungen und das Übersetzungs-Dashboard). Er ist unabhängig von sourceLocale / targetLocales und wird durch das Flag -L / --ui-lang sowie die Umgebungsvariable AI_I18N_LANG überschrieben. Unbekannte Werte werden ordnungsgemäß auf das Quellgebietsschema (en-GB) herabgestuft – es gibt keine strikte Validierung. Siehe Tool-UI-Sprache.


languagesManifestPath (optional) ​

Optionale Zeichenfolge auf Root-Ebene. Der Sprachumschalter der Dokumentation liest diesen Pfad. Wenn er weggelassen wird, wird standardmäßig das Manifest des ersten UI-Blocks verwendet: languagesManifestPath dieses Blocks oder {flatOutputDir}/ui-languages.json. Jeder UI-Block kann seine eigene languagesManifestPath festlegen; Block 0 verwendet diesen Root-Pfad, wenn der Block seinen eigenen weglässt.

Verwenden Sie dies, wenn:

  • Das Manifest sollte sich außerhalb von ui.flatOutputDir befinden (z. B. neben App-Helfern unter src/i18n/).
  • Sie möchten die Nachbearbeitung des Sprachumschalters (languageListBlock), um Gebietsschema-Bezeichnungen aus dem Projektmanifest und nicht nur aus dem gebündelten Masterkatalog zu erstellen.

includeUiLanguageEnglishNames liest diese Datei nicht – es verwendet den gebündelten Masterkatalog (siehe ui.uiExtractor unten).

Legacy: Das Stammverzeichnis uiLanguagesPath wird beim Laden einer Konfigurationsdatei weiterhin akzeptiert und automatisch in languagesManifestPath umgeschrieben.


concurrency (optional) ​

Maximale Anzahl gleichzeitig übersetzter Ziellokale (translate-ui, translate-docs, translate-svg und die entsprechenden Schritte innerhalb von sync). Wird dies weggelassen, verwendet die CLI 4 für die UI-Übersetzung und 3 für die Dokumentationsübersetzung (integrierte Standardwerte). Pro Lauf mit -j / --concurrency überschreiben.


batchConcurrency (optional) ​

translate-docs, translate-svg und translate-json (und die entsprechenden Schritte in sync): maximale parallele LLM-Batch-Anfragen pro Datei (jeder Batch kann viele Segmente enthalten). Standardwert 4, wenn weggelassen. Gilt nicht für translate-ui – verwenden Sie stattdessen uiBatchConcurrency. Überschreiben Sie dies mit -b / --batch-concurrency.


uiBatchConcurrency (optional) ​

translate-ui, sync-ui und der UI-Schritt von sync: maximale parallele LLM-Batch-Anfragen innerhalb eines einzelnen Gebietsschemas (einfache Zeichenfolgen-Chunks von 50, dann Pluralgruppen). Standardwert 2, wenn weggelassen. Unabhängig von concurrency (parallele Ziel-Gebietsschemas) und batchConcurrency (Dokumente/JSON/SVG). Kein CLI-Flag; in der Konfiguration festlegen oder uiBatchConcurrency an das programmatische runTranslateUI übergeben.

Beispiel:

json
{
  "uiBatchConcurrency": 2
}

Bei der Standard-Locale-Parallelität von 4 sind das bis zu 8 UI-API-Aufrufe, die gleichzeitig ausgeführt werden. Erhöhen Sie diesen Wert, wenn Sie eine große Locale (-l de) übersetzen; halten Sie ihn niedrig, wenn der Anbieter Ratenbegrenzungen vornimmt.


fileConcurrency (optional) ​

Maximale Anzahl gleichzeitig verarbeiteter Dateien innerhalb einer einzelnen Sprachumgebung während translate-docs und sync. Bei Werten größer als 1 werden Dateien innerhalb derselben Sprachumgebung parallel verarbeitet, wobei ein Semaphore zur Steuerung des Speicherverbrauchs verwendet wird. Standardwert ist 1 (sequenzielle Verarbeitung), wenn nicht angegeben. Höhere Werte können den Durchsatz bei I/O-gebundenen Operationen erheblich verbessern, insbesondere wenn alle Segmente bereits zwischengespeichert sind (keine API-Aufrufe erforderlich).

Beispiel:

json
{
  "fileConcurrency": 4
}

Anwendungsfall: Setzen Sie dies auf 2-4, wenn Sie sync --force-update mit 100 % Cache-Treffern ausführen, um die Gesamtverarbeitungszeit zu verkürzen. Die Verbesserung ist besonders bei vielen kleinen Dateien deutlich spürbar.


batchSize / maxBatchChars (optional) ​

Segment-Batching für translate-docs, translate-svg und translate-json: wie viele Segmente pro API-Anfrage und eine Zeichenobergrenze. Standardwerte: 20 Segmente, 4096 Zeichen (wenn weggelassen).


requestTimeout / requestTimeoutMs (optional) ​

Maximale Wartezeit für jede LLM-Anfrage, für jeden Anbieter. requestTimeout sind ganze Sekunden; requestTimeoutMs sind Millisekunden. Standard: 120 Sekunden, wenn beide weggelassen werden. Legen Sie nur eines von beiden fest. Ein Anbieter, der eines der Felder festlegt, verwendet stattdessen diesen Wert, nur für diesen Anbieter.


provider und providers ​

provider (Top-Level, optional) wählt den aktiven Provider-Schlüssel aus providers. Er ist optional, wenn genau ein Provider konfiguriert ist; erforderlich, wenn mehr als einer konfiguriert ist.

providers (Top-Level) ordnet einen Provider-Schlüssel seinem Block zu. Eingebaute Schlüssel (siehe Preset-Tabelle unten) benötigen nur translationModels; jeder andere Schlüssel definiert einen benutzerdefinierten OpenAI-kompatiblen Endpunkt und erfordert baseUrl (plus apiKeyEnv, es sei denn, der Endpunkt benötigt keinen Schlüssel).

Jeder providers.<name>-Block akzeptiert:

  • translationModels Bevorzugte geordnete Liste von Modell-IDs (einfache Upstream-IDs, kein provider/-Präfix; OpenRouter-IDs behalten ihre native vendor/model-Form). Der erste Eintrag wird zuerst versucht; spätere Einträge dienen als Fallbacks bei Fehlern. Dies ist die globale Standardkette für jede Pipeline, wenn keine spezifischere Stufe zutrifft.
  • uiModels (optional) Geordnete Liste von Modellen nur für die Benutzeroberfläche für translate-ui, Pluralgenerierung (Schritt 0 und Durchlauf B) und proofread-ui. Wird nach jedem passenden localeModels-Eintrag für das Ziellokal versucht, vor translationModels.
  • localeModels (optional) Lokalspezifische Überschreibungen für alle Übersetzungs-Pipelines. Array von { "locale": "<BCP-47>", "models": ["…"] }-Objekten. Lokale-Tags werden ohne Berücksichtigung der Groß-/Kleinschreibung abgeglichen (pt-br = pt-BR). Die Liste jedes Lokals wird zuerst nur für dieses Lokal versucht, dann Pipeline-spezifische Stufen (uiModels für UI) und translationModels. Doppelte normalisierte Lokale-Schlüssel werden beim Laden der Konfiguration abgelehnt.
  • baseUrl OpenAI-kompatible Basis-URL. Überschreibt die voreingestellte Basis-URL; erforderlich für einen nicht voreingestellten Anbieter.
  • apiKeyEnv Umgebungsvariable, die den API-Schlüssel enthält. Überschreibt die voreingestellte Umgebungsvariable.
  • headers Zusätzliche HTTP-Header, die mit jeder Anfrage an diesen Anbieter gesendet werden.
  • maxTokens Maximale Vervollständigungs-Tokens pro Anfrage. Standard: 8192.
  • temperature Sampling-Temperatur. Standard: 0.2.
  • requestTimeout Maximale Wartezeit in Sekunden für jede Anfrage an diesen Anbieter. Überschreibt die übergeordnete requestTimeout / requestTimeoutMs. Wenn weder dieser Anbieter noch die übergeordnete Konfiguration ein Timeout festlegt, beträgt der Standardwert 120 Sekunden. Legen Sie nur eines von requestTimeout und requestTimeoutMs für dasselbe Objekt fest.
  • requestTimeoutMs Maximale Wartezeit in Millisekunden für jede Anfrage an diesen Anbieter. Überschreibt die übergeordnete requestTimeout / requestTimeoutMs. Wenn weder dieser Anbieter noch die übergeordnete Konfiguration ein Timeout festlegt, beträgt der Standardwert 120000 (120 Sekunden). Legen Sie nur eines von requestTimeout und requestTimeoutMs für dasselbe Objekt fest.
  • pricing (optional) Anbieterweite USD pro 1 Mio. Tokens: { "inputPerMTokens": 0.15, "outputPerMTokens": 0.6 }. Wenn ein abgerechneter Aufruf keine vom Anbieter gemeldeten usage.cost hat (die meisten Anbieter außer OpenRouter und Cheaper Inference), wird dieser Satz auf die Eingabe- und Ausgabe-Tokens dieses Aufrufs angewendet. Der Betrag ist in der Übersetzungszusammenfassung enthalten und wird in der Zeile api_calls gespeichert.

Die Kostenquelle wird in dieser Reihenfolge aufgelöst:

  1. ein passender modelPricing-Eintrag (überschreibt diesen Anbieter-Standard);
  2. ein vom Anbieter gemeldeter Preis (wird nie ersetzt);
  3. dieser pricing-Satz;
  4. der models.dev-Listenpreis für diese Modell-ID (Eingabe- und Ausgabe-USD pro 1 Mio. Tokens).

Zeilen, die ohne Kosten gespeichert wurden, können später immer noch über usage und Nutzung & Kosten geschätzt werden. Wenn keine dieser Quellen zutrifft, bleiben die Kosten unbekannt (—), niemals $0.00.

  • modelPricing (optional) Modellspezifische USD pro 1 Mio. Tokens: { "<model-id>": { "inputPerMTokens": 2.5, "outputPerMTokens": 10 } }. Überschreibt pricing für diese Modell-ID. Wird zum Zeitpunkt des Aufrufs angewendet, wenn der Anbieter usage.cost weggelassen hat, und mit dem Aufruf gespeichert.
  • zeroDataRetention (optional, nur providers.cheaperinference) Wenn true, senden Chat-Anfragen "zdr": true und list-models, check-models, und suggest-models laden GET /v1/models?zdr=true. Weggelassen bedeutet ausgeschaltet. Siehe Zero data retention.

Integrierte Anbieter-Presets (Schlüssel — Basis-URL — API-Schlüssel-Umgebungsvariable):

AnbieterBasis-URLUmgebungsvariable für API-Schlüssel
alibabahttps://dashscope-intl.aliyuncs.com/compatible-mode/v1ALIBABA_API_KEY
anthropichttps://api.anthropic.com/v1ANTHROPIC_API_KEY
apikeyfanhttps://api.apikey.fan/v1APIKEYFAN_API_KEY
cerebrashttps://api.cerebras.ai/v1CEREBRAS_API_KEY
cheaperinferencehttps://api.cheaperinference.com/v1CHEAPERINFERENCE_API_KEY
deepseekhttps://api.deepseek.comDEEPSEEK_API_KEY
geminihttps://generativelanguage.googleapis.com/v1beta/openaiGOOGLE_API_KEY
groqhttps://api.groq.com/openai/v1GROQ_API_KEY
mistralhttps://api.mistral.ai/v1MISTRAL_API_KEY
nvidiahttps://integrate.api.nvidia.com/v1NVIDIA_API_KEY
ollamahttp://localhost:11434/v1(keine)
openaihttps://api.openai.com/v1OPENAI_API_KEY
openrouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
xaihttps://api.x.ai/v1XAI_API_KEY

Das apifun-Preset wurde in apikeyfan umbenannt. Aktualisieren Sie die Schlüssel provider und providers in bestehenden Konfigurationen; APIFUN_API_KEY bleibt ein Alias für APIKEYFAN_API_KEY.

Ein veralteter übergeordneter openrouter-Block (mit baseUrl, translationModels, defaultModel, fallbackModel, maxTokens, temperature, requestTimeout, requestTimeoutMs) wird weiterhin akzeptiert und beim Laden automatisch zu providers.openrouter (mit provider: "openrouter") migriert; defaultModel / fallbackModel werden in translationModels zusammengeführt.

Ein ausführbares Beispiel, das mehrere Anbieter in einer Konfiguration konfiguriert und mit -P zwischen ihnen wechselt, finden Sie unter examples/multi-provider (openai, anthropic, openrouter und deepseek im selben Dokument).

Warum mehrere Modelle verwenden: Verschiedene Anbieter und Modelle haben unterschiedliche Kosten und bieten unterschiedliche Qualitätsstufen für verschiedene Sprachen und Gebietsschemata. Konfigurieren Sie translationModels als eine geordnete Fallback-Kette, damit die CLI das nächste Modell versuchen kann, wenn eine Anfrage fehlschlägt. Die Anleitung zum Erstellen dieser Liste finden Sie unter KI-Modelle.

Betrachten Sie die folgende Liste als Grundlage. Ersetzen Sie sie durch die Benchmark-Rangliste unter KI-Modelle. Wenn die Übersetzungsqualität für ein bestimmtes Gebietsschema weiterhin schlecht ist, fügen Sie einen localeModels-Eintrag für diese Sprache oder Schrift hinzu oder fügen Sie weitere IDs aus dem Katalog des Anbieters hinzu.

Diese Modell-IDs sind das, was ai-i18n-tools init -P openrouter schreibt. Andere Voreinstellungen erhalten native Modell-IDs von init -P <provider> — siehe Integrierte Anbieter.

Diese Liste wurde auf umfassende Abdeckung verschiedener Sprachen in einem großen Dokumentationsprojekt mit 36 Ziel-Lokalisierungen getestet; sie dient als praktischer Standard, ist jedoch nicht garantiert für jede Lokalisierung optimal.

Beispiel translationModels (OpenRouter-Liste von ai-i18n-tools init -P openrouter):

OpenRouter translationModels-Liste
json
"translationModels": [
  "google/gemini-2.5-flash",
  "meta-llama/llama-3.3-70b-instruct",
  "openai/gpt-4o-mini",
  "google/gemma-4-26b-a4b-it",
  "~anthropic/claude-haiku-latest",
  "z-ai/glm-5.2",
  "google/gemini-3.5-flash",
  "~anthropic/claude-sonnet-latest"
  // … add more fallback models as needed
]

Empfohlene uiModels: UI-Strings sind kurz, aber sehr sichtbar – ein Premium-Modell verbessert oft Ton, Pluralformen und Konsistenz. Optionale uiModels wird nach jedem passenden localeModels-Eintrag und vor translationModels versucht (siehe die Feldliste oben). Beispiel:

Empfohlene uiModels für die UI-Übersetzung
json
"uiModels": [
  "~anthropic/claude-sonnet-latest",
  "z-ai/glm-5.2"
]

Empfohlene localeModels für asiatische Sprachen: Japanische, koreanische und chinesische Gebietsschemata profitieren oft von Modellen, die auf diese Schriften abgestimmt sind. Fügen Sie pro Gebietsschema Überschreibungen hinzu, die zuerst (vor uiModels / translationModels) versucht werden, wenn das Zielgebietsschema übereinstimmt:

Empfohlene localeModels für ja, ko, zh-Hans, zh-Hant
json
"localeModels": [
  { "locale": "ja",      "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "ko",      "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "zh-Hans", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "zh-Hant", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] }
]

Legen Sie die API-Schlüssel-Umgebungsvariable des aktiven Anbieters (siehe die Voreinstellungstabelle) in Ihrer Umgebung oder in der Datei .env fest.

Bevor Sie Modelllisten ändern, führen Sie ai-i18n-tools check-models aus. Für jeden Anbieter überprüft es jede konfigurierte Modell-ID (translationModels, uiModels und alle localeModels-Einträge) anhand der Live-Modellliste des Anbieters (GET /models), meldet fehlende oder veraltete IDs (expiration_date), listet die gültigen Modelle auf und beendet den Vorgang mit einem Fehlercode ungleich Null, wenn eine konfigurierte ID ungültig ist. Wenn der Anbieter Preise zurückgibt (z. B. OpenRouter), werden auch die geschätzten Eingabe-/Ausgabepreise (USD pro 1 Mio. Tokens) angezeigt.

Um die konfigurierten Modelle bei realen Übersetzungsarbeiten zu vergleichen, führen Sie ai-i18n-tools bench-models aus. Es bewertet jede eindeutige Modell-ID aus translationModels, uiModels und localeModels, indem es ein Beispiel isoliert (parallel, begrenzt durch concurrency) durch jedes Modell übersetzt und die Eingabe-/Ausgabe-Tokens pro Modell, die tatsächliche Zeit und die USD-Kosten ausgibt, sodass Sie die Geschwindigkeit gegen den Preis abwägen können, bevor Sie sich für Modelllisten entscheiden.


features ​

FeldPipelineBeschreibung
translateUIStrings1Extrahiert t("…") / i18n.t("…") in strings.json, übersetzt dann Einträge und schreibt Flat JSON pro Gebietsschema (die Extraktion läuft automatisch; verwenden Sie das eigenständige extract, um nur den Katalog zu aktualisieren).
translateDocs2.md / .mdx / .astro / .html / .htm-Seiten übersetzen; Docusaurus-Shell-JSON, wenn docs[].docusaurusCatalogDir gesetzt ist; Nextra-_meta / Wörterbuch, wenn konfiguriert; VitePress-Theme, wenn docsOutput.vitepressThemeCatalog gesetzt ist; Fumadocs-meta.json / UI-Katalog, wenn docsOutput.style auf "fumadocs" gesetzt ist.
translateJson3Beliebige verschachtelte JSON-Struktur unter json[] (translate-json).
translateSVG—Übersetzen Sie .svg-Dateien (erfordert den svg-Block auf oberster Ebene).

Jedes Flag hat den Standardwert true, wenn der Schlüssel weggelassen wird. Das Verhalten ist:

  • Ein weggelassenes true ohne zu übersetzenden Inhalt wird übersprungen: kein UI-Block hat sourceRoots, kein Docs-Block hat contentPaths oder docusaurusCatalogDir, json[] hat kein contentPaths, oder svg ist nicht gesetzt.
  • Das Schreiben des Flags als true, wenn diese Pipeline keine Arbeit hat, ist ein Konfigurationsfehler.
  • Das Schreiben von false schaltet diese Pipeline für sync aus, selbst wenn Quellen vorhanden sind.
  • --no-ui, --no-docs, --no-json und --no-svg überspringen den Schritt für einen Lauf.

Übersetzen Sie SVG-Dateien mit translate-svg, wenn features.translateSVG wahr ist und ein svg-Block auf oberster Ebene konfiguriert ist. Der Befehl sync führt diesen Schritt aus, wenn das Flag aktiviert und svg gesetzt ist (außer --no-svg).


ui ​

Ein Katalogobjekt oder ein Array von Katalogblöcken (dasselbe Prinzip wie bei docs[]). Ein einzelnes Objekt wird beim Laden akzeptiert und in ein Array mit einem Element umgewandelt; die Datei auf der Festplatte wird nicht neu geschrieben. Nach dem Parsen ist config.ui immer ein Array.

extract, translate-ui, sync-ui, die UI-Phase von sync, proofread-ui, export-ui-xliff, generate-ui-languages und purge-locale durchlaufen jeden Block, der sourceRoots hat. Übergeben Sie --ui-block mit einem nullbasierten Index, der description des Blocks oder seinem stringsJson-Pfad, um einen einzelnen Block auszuführen. status und statistics listen jeden Block auf, der Quellen oder einen vorhandenen Katalog hat. Das Übersetzungs-Dashboard listet jeden solchen Katalog auf und zeigt eine Auswahl an, wenn mehr als einer vorhanden ist.

Aufgelöste stringsJson-, flatOutputDir- und Manifest-Pfade müssen blockübergreifend eindeutig sein. description-Werte müssen eindeutig sein, wenn sie gesetzt sind, da --ui-block sie exakt abgleicht.

  • description Optionale Notiz für Personen, die die Konfiguration lesen (wird nicht an das Modell gesendet). Wird als ui[i] — description in Befehlsheadern, status, statistics und im Dashboard angezeigt.
  • sourceRoots Verzeichnisse oder Glob-Muster (relativ zum cwd), die nach t("…")-Aufrufen durchsucht werden. Unterstützt Muster wie src/ oder ["src/**/*.ts"]. Ein Block mit einer leeren Liste wird übersprungen, es sei denn, --ui-block benennt ihn, was ein Fehler ist.
  • stringsJson Pfad zur Master-Katalogdatei dieses Blocks. Wird von extract aktualisiert.
  • flatOutputDir Verzeichnis, in das die gebietsschemaspezifischen JSON-Dateien dieses Blocks geschrieben werden (de.json usw.).
  • flatOutput Wenn true (Standard), schreibt translate-ui eine flache JSON-Datei pro Gebietsschema. Legen Sie false fest, um nur gettext oder resx auszugeben. Ein Block mit flatOutput: false muss gettext oder resx festlegen.
  • resx Optionale .NET .resx-Ausgabe. outputDir (Standard Resources) und baseName (Standard SharedResource) schreiben {baseName}.resx plus {baseName}.{culture}.resx. writeNeutral (Standard true) legt den Quelltext in der neutralen Datei ab, damit ResourceManager darauf zurückgreifen kann. localeFormat ist bcp47 (Standard, pt-BR) oder posix (pt_BR). ingestExistingResx (Standard true) liest Satelliten während extract. neutralFile ordnet ältere benannte Schlüssel wie LoginButton über den neutralen Wert zu. Kontextschlüssel verwenden U+2404. Pluralformen sind separate Einträge namens {singular}[{form}]. Ein Block mit flatOutput: false muss gettext oder resx festlegen.
  • gettext Optionale GNU gettext-Ausgabe für diesen Block. outputDir (Standard ./locales) empfängt <locale>/LC_MESSAGES/<domain>.po und, wenn compileMo wahr ist (Standard), die passende .mo. domain ist standardmäßig messages. potPath ist der Vorlagenkatalog. ingestExistingPo (Standard true) füllt leere strings.json-Slots mit nicht-unscharfen msgstr-Werten während extract und ersetzt keine nicht-leere oder vom Benutzer bearbeitete Übersetzung. localeFormat ist posix (Standard, pt_BR) oder bcp47 (pt-BR). Kontextbezogene Zeilen verwenden den gettext \u0004-Trenner. Dieselbe Quellsprachenzeichenfolge in zwei Kontexten teilt sich keine Katalog-ID.
  • targetLocales Optionale Gebietsschemaliste für diesen Block. Wenn weggelassen oder leer, verwendet der Block das Stamm-targetLocales.
  • languagesManifestPath Optionaler Pfad, unter dem extract und generate-ui-languages die ui-languages.json dieses Blocks schreiben. Wenn weggelassen, verwendet Block 0 das Stamm-languagesManifestPath (das selbst standardmäßig die {flatOutputDir}/ui-languages.json dieses Blocks verwendet). Spätere Blöcke verwenden standardmäßig {flatOutputDir}/ui-languages.json.
  • uiGlossary Wenn true (Standard), ist die strings.json dieses Blocks eine Glossar-Hinweisquelle für translate-docs, translate-json und translate-svg. translate-ui, proofread-ui und Quell-Linting verwenden nur glossary.userGlossary. Legen Sie false fest, um einen Katalog von diesen Hinweisen auszuschließen (zum Beispiel einen CLI-String-Katalog, der die Dokumentation nicht beeinflussen sollte).
  • uiExtractor.funcNames (oder älteres reactExtractor.funcNames) Zusätzliche Funktionsnamen zum Scannen (Standard: ["t", "i18n.t"]).
  • uiExtractor.extensions (oder älteres reactExtractor.extensions) Dateierweiterungen zum Einschließen (Standard: [".js", ".jsx", ".ts", ".tsx"]). Fügen Sie .astro für Astro-Frontmatter und Vorlagenausdrücke hinzu.
  • uiExtractor.includePackageDescription (oder älteres reactExtractor.includePackageDescription) Wenn true (Standard), enthält extract auch package.json description als UI-String, falls vorhanden. Legen Sie false für zusätzliche Blöcke fest, damit dieselbe Beschreibung nicht in jeden Katalog extrahiert wird.
  • uiExtractor.packageJsonPath (oder älteres reactExtractor.packageJsonPath) Benutzerdefinierter Pfad zur package.json-Datei, die für diese optionale Beschreibungsextraktion verwendet wird.
  • uiExtractor.includeUiLanguageEnglishNames (oder älteres reactExtractor.includeUiLanguageEnglishNames)

Wenn true (Standard false), fügt extract auch jedes englishName aus dem gebündelten ui-languages Masterkatalog (erstellt aus sourceLocale + dem effektiven targetLocales des Blocks) zu strings.json hinzu, wenn es nicht bereits aus dem Quellscan vorhanden ist (gleiche Hash-Schlüssel). Liest languagesManifestPath nicht.

  • uiExtractor.placeholderStyledefault (Mustache, Python-Formatfelder und Printf) oder dotnet (nur {0}, {0,-10}, {0:format}). Im dotnet-Stil ist ein Prozentzeichen ein Literaltext und doppelte geschweifte Klammern sind Literal-Klammern. Die ui-dotnet-Vorlage setzt dotnet.
  • uiExtractor.exclude Minimatch-Muster, relativ zum Projekt-Root, werden nach dem Scan verworfen. bin, obj, .vs, TestResults und packages werden bereits anhand des Verzeichnisnamens übersprungen. Die ui-dotnet- und ui-dotnet-resx-Vorlagen schließen **/Tests/**, **/*.Tests/** und **/TrExtension.cs aus.

glossary.uiGlossary und glossary.uiGlossaryFromStringsJson werden nicht mehr akzeptiert. Das Laden der Konfiguration schlägt fehl und der Fehler erklärt die Ersetzung: Löschen Sie den Schlüssel. Hinweise stammen jetzt aus dem uiGlossary-Flag jedes Blocks (Standard true).


cacheDir ​

  • cacheDir SQLite-Cache-Verzeichnis (wird von allen docs-Blöcken gemeinsam genutzt). Standard .translation-cache. Wiederverwendung über Durchläufe hinweg. Wenn Sie von einem benutzerdefinierten Dokument-Übersetzungscache migrieren, archivieren oder löschen Sie diesen – cacheDir erstellt eine eigene SQLite-Datenbank und ist nicht mit anderen Schemas kompatibel. suggest-models speichert auch Benchmark-Aggregate in <cacheDir>/benchmark-scores.json. Diese Datei ist ein Cache, wie der Rest des Verzeichnisses, und ist nicht Teil des veröffentlichten Pakets.

Best Practice für git-Ausschlüsse: ​

  • Den Inhalt des Übersetzungscache-Ordners ausschließen (zum Beispiel mit .gitignore oder .git/info/exclude), um zu verhindern, dass temporäre Cache-Artefakte committet werden.
  • cache.db beibehalten (nicht routinemäßig löschen), da das Beibehalten des SQLite-Caches ein erneutes Übersetzen unveränderter Segmente verhindert. Dies spart sowohl Laufzeit- als auch API-Kosten beim Aktualisieren oder Ändern von Software, die ai-i18n-tools verwendet.
  • Umgebungsdateien und temporäre Dateien ausschließen, damit Geheimnisse und Backups nicht committet werden.

Beispiel:

init schreibt diesen Block für das Standard-cacheDir. Wenn cacheDir abweicht, verwenden die beiden Cache-Zeilen dieses Verzeichnis, zum Beispiel .i18n-cache/* und !.i18n-cache/cache.db.

gitignore
# Cache
.translation-cache/*
!.translation-cache/cache.db
benchmark-scores.json

# Environment
.env
.env.local
.env.*.local

# Temporary files
*.tmp
*.backup.*

docs ​

Array von Dokumentationspipeline-Blöcken. translate-docs und die Dokumentationsphase von sync verarbeiten jeden Block der Reihe nach. Legacy-Schlüssel werden zur Ladezeit weiterhin akzeptiert und neu geschrieben, wenn die Konfigurationsdatei beschreibbar ist; bevorzugen Sie aktuelle Namen in neuen Konfigurationen.

Legacy-SchlüsselAktueller Schlüssel / Verhalten
documentationsdocs
markdownOutputdocs[].docsOutput
jsonSourcedocs[].docusaurusCatalogDir
Top-Level openrouterproviders.openrouter + provider: "openrouter"
features.translateMarkdownfeatures.translateDocs
features.translateJSONentfernt (verwenden Sie docs[].docusaurusCatalogDir oder json[])
features.extractUIStringsentfernt (extract läuft vor der UI-Übersetzung)
glossary.uiGlossary und glossary.uiGlossaryFromStringsJsonentfernt; das Laden der Konfiguration schlägt fehl. Verwenden Sie ui[].uiGlossary (boolesch, Standardwert true)
ui.reactExtractorui.uiExtractor (Alias wird weiterhin akzeptiert)
svg.svgExtractor.forceLowercasesvg.forceLowercase

Inhaltsquellen

  • description Optionale, menschenlesbare Notiz für diesen Block (wird nicht für Übersetzungen verwendet). Wird bei Angabe dem translate-docs-🌐-Überschriftentitel vorangestellt; erscheint auch in status-Abschnittsüberschriften.
  • contentPaths Markdown-/MDX-Seiteninhalte und .astro-Vorlagen, die übersetzt werden sollen (translate-docs durchsucht diese nach .md, .mdx und .astro). Unterstützt Verzeichnispfade oder Glob-Muster (z. B. "docs/**/*.md", "guides/*.mdx", "src/pages/index.astro"). Hieraus stammt der lokalisierte Dokumentationstext.
  • sourceFiles Optionaler Alias, der beim Laden in contentPaths zusammengeführt wird.
  • targetLocales Optionale Untermenge von Sprachen (Lokalisierungen) nur für diesen Block (sonst die obergeordnete targetLocales). Die wirksamen Dokumentationssprachen ergeben sich als Vereinigung über alle Blöcke.
  • docusaurusCatalogDir Optional. Quellverzeichnis für Docusaurus-JSON-Label-Kataloge für diesen Block (z. B. "i18n/en" von docusaurus write-translations). Seiteninhalte stammen immer von contentPaths; docusaurusCatalogDir liefert nur Shell-/UI-JSON, nicht MDX.
  • nextraMetaGlob Optionale Glob(s) für Nextra _meta.ts / _meta.tsx / _meta.js unter docsRoot. Wenn docsOutput.style auf "nextra" gesetzt ist und dies weggelassen wird, werden alle _meta-Dateien unter docsRoot automatisch gesammelt.
  • nextraMetaTranslatableKeys Optionale Eigenschaftsnamen, deren Zeichenfolgenwerte in Nextra _meta-Objekten übersetzt werden (Standard: title, display, breadcrumb).
  • nextraDictionaryPath Optionales englisches Nextra-Theme-Wörterbuchmodul (z. B. "app/_dictionaries/en.ts"). Wird während {dir}/{locale}.ts nach translate-docs übersetzt.
  • nextraDictionaryOutputTemplate Optionale Ausgabevorlage für lokale Wörterbuchmodule (Standard: {dir}/{locale}.ts relativ zum Wörterbuchverzeichnis).

docsOutput ​

Ausgabelayout für diesen Block.

  • outputDir Stammverzeichnis für die übersetzte Ausgabe dieses Blocks.
  • docsOutput.style"nested" (Standard), "flat", "doc-system" oder Aliase "docusaurus" / "astro-starlight" / "vitepress" / "nextra".
  • docsOutput.localeSubpath Pfadsegment zwischen {locale}/ und {relativeToDocsRoot} für doc-system (erforderlich bei direkter Verwendung von style: "doc-system"; voreingestellt bei Verwendung eines Alias). Verwenden Sie "" für Starlight-ähnliche Locale-Ordner.
  • docsOutput.docsRoot Quell-Dokumentationsstamm für Docusaurus-Layout (z. B. "docs"). Standard "docs", wenn weggelassen.
  • docsOutput.pathTemplate Benutzerdefinierter Markdown-Ausgabepfad. Platzhalter: "{outputDir}", "{locale}", "{LOCALE}", "{llocale}", "{relPath}", "{stem}", "{basename}", "{extension}", "{docsRoot}", "{relativeToDocsRoot}".
  • docsOutput.jsonPathTemplate Benutzerdefinierter JSON-Ausgabepfad für Label-Dateien. Unterstützt die gleichen Platzhalter wie pathTemplate.
  • docsOutput.localePathLowercase Wenn true, verwenden integrierte Ausgabelayouts (nested, flat, doc-system ohne pathTemplate) kleingeschriebene Gebietsschema-Segmente in Pfaden. Standard false; astro-starlight und doc-system mit leerem localeSubpath standardmäßig auf true beim Laden der Konfiguration.
  • docsOutput.flatPreserveRelativeDir Wenn docsOutput.style = "flat", Quellunterverzeichnisse beibehalten, damit Dateien mit demselben Basisnamen nicht kollidieren. Standard false.
  • docsOutput.rewriteRelativeLinks Relative Links nach der Übersetzung umschreiben (automatisch aktiviert, wenn docsOutput.style = "flat" und keine benutzerdefinierte pathTemplate).
  • docsOutput.linkRewriteDocsRoot Repo-Stammverzeichnis, das beim Berechnen von Präfixen für das Umschreiben von Flat-Links verwendet wird. Belassen Sie dies normalerweise als ".", es sei denn, Ihre übersetzten Dokumente befinden sich unter einem anderen Projekt-Stammverzeichnis.
  • docsOutput.rewriteVitepressLinks Wenn true, den VitePress-Link-Normalisierer nach der Übersetzung ausführen. Standardmäßig aktiviert, wenn docsOutput.style "vitepress" ist. Verwenden Sie dies mit jedem doc-system-Layout, bei dem sich Locale-Ordner neben den Quelldateien unter docsRoot befinden. Die Ausgangssprache ist sourceLocale und kann jede Sprache sein. Schreibt README-ähnliche docs/guide/…-Pfade in Site-Routen (/guide/…) und locale-relative ../guide/…-Links um. Für Links zu Repo-Dateien außerhalb des VitePress-Baums (LICENSE, examples/) verwenden Sie vollständige URLs in den Quelldateien – siehe VitePress-Integration – README als Dokumentations-Homepage.
  • docsOutput.rewriteNextraLinks Wenn true, den Nextra-Link-Normalisierer nach der Übersetzung ausführen. Standardmäßig aktiviert, wenn docsOutput.style "nextra" ist. Schreibt content/en/… und relative .mdx-Pfade in locale-neutrale Site-Routen (/guide/…) für Next.js i18n um. Siehe Nextra-Integration – Link-Konventionen.
  • docsOutput.fumadocsParser"dot" (Standard) oder "dir". Dot schreibt stem.{locale}.mdx neben die Quelldateien; dir schreibt Locale-Ordner wie Nextra. Die Ausgangssprache ist sourceLocale und kann jede Sprache sein. Siehe Fumadocs-Integration – Seitenlayout.
  • docsOutput.rewriteFumadocsLinks Wenn true, den Fumadocs-Link-Normalisierer nach der Übersetzung ausführen. Standardmäßig aktiviert, wenn docsOutput.style "fumadocs" ist. Schreibt Inhaltspfade und relative .mdx-Links in /docs/…-Routen um.
  • docsOutput.fumadocsUiCatalog Optional. Fumadocs UI-Überschreibungskatalog-Bootstrap + Übersetzung innerhalb von translate-docs. Felder: sourcePath (z. B. lib/layout.shared.ts), catalogPath (generiertes englisches JSON), optional outputPathTemplate (Standard: ui.{locale}.json neben catalogPath).
  • docs[].fumadocsMetaGlob Optionale Glob(s) für die meta.json-Sammlung, wenn docsOutput.style "fumadocs" ist. Standard: rekursives meta.json unter docsOutput.docsRoot.
  • docs[].fumadocsMetaTranslatableKeys Eigenschaftsnamen, deren String-Werte in Fumadocs-meta.json übersetzt werden (Standard: title, description).
  • docsOutput.localizedAssets Optionale Umbenennung von Bild- und Symbol-URLs im übersetzten HTML, wenn eine Locale-Datei vorhanden ist. Felder: include (Standard img/**), pattern (Standard {stem}-{locale}{ext}), onlyIfExists (Standard true), assetRoot (Verzeichnis zum Testen von Root-relativen URLs; Standard ist das Verzeichnis der HTML-Datei). Platzhalter: {stem}, {ext}, {basename}, {locale}, {llocale}, {LOCALE}. CSS-url() wird nicht umgeschrieben. Siehe HTML-Seiten.
  • docsOutput.html Optionale Sprachliste und hreflang für HTML-Dokumente. Standardkommentare sind <!-- ai-i18n:lang-list --> … <!-- /ai-i18n:lang-list --> und <!-- ai-i18n:hreflang --> … <!-- /ai-i18n:hreflang -->. languageList.format ist links oder select. languageList.label ist local, english oder both. hreflang.siteUrl stellt alternativen Links ein Präfix voran; wenn weggelassen, sind die Links relativ und es wird eine Warnung protokolliert. hreflang.xDefault ist standardmäßig sourceLocale. hreflang.stripIndexHtml wandelt index.html in eine Verzeichnis-URL um. Für HTML wird docsRoot entfernt, bevor der Locale-Ordner hinzugefügt wird (site/index.html → site/{locale}/index.html, wenn docsRoot auf site gesetzt ist). Siehe HTML-Seiten.
  • docsOutput.vitepressThemeCatalog Optional. Bootstrap des VitePress-Theme/Navigation/Sidebar-Katalogs + Übersetzung innerhalb von translate-docs. Felder: configPath (VitePress-Konfiguration mit Theme-Strings), catalogPath (generiertes englisches verschachteltes JSON), optional outputPathTemplate (Standard: theme.{locale}.json neben catalogPath).

Nachbearbeitung

  • docsOutput.postProcessing Optionale Transformationen am übersetzten Markdown-Textkörper (YAML-Schlüssel und nicht-prosaartige Frontmatter-Werte bleiben erhalten). Wird nach der Segmentwiederherstellung und Link-Umschreibung (flat oder VitePress) und vor addFrontmatter ausgeführt.
  • docsOutput.postProcessing.regexAdjustments Geordnete Liste von { "description"?, "search", "replace" }. search ist ein Regex-Muster (einfache Zeichenfolge verwendet Flag g oder /pattern/flags). replace unterstützt Platzhalter wie ${translatedLocale}, ${sourceLocale}, ${sourceFullPath}, ${translatedFullPath}, ${sourceFilename}, ${translatedFilename}, ${sourceBasedir}, ${translatedBasedir}.
  • docsOutput.postProcessing.languageListBlock{ "start", "end", "separator", "label"? } – generiert eine begrenzte „in anderen Sprachen lesen“-Linkzeile in Quell- und übersetztem Markdown neu. Erfordert languagesManifestPath (oder ein Manifest unter ui.flatOutputDir/ui-languages.json) für Endonym-Bezeichnungen, wenn label: "local".

Verhalten und Metadaten

  • translateFrontmatterFields Gleiche Ebene wie docsOutput (pro docs[]-Block). Standard true: übersetzt benutzerorientierte YAML-Prosa für Starlight/Docusaurus (title, description, sidebar.label, sidebar_label, keywords, hero.title, hero.tagline, hero.image.alt, hero.actions[].text, pagination_label, prev/next-Beschriftungen). Setzen Sie false, um den gesamten Front-Matter-Block unverändert zu lassen; übergeben Sie ein String-Array, um auf bestimmte Dot-Pfade zu beschränken.
  • segmentSplitting Gleiche Ebene wie docsOutput (pro docs[]-Block). Optionale feiner granulierte Segmente für die translate-docs-Extraktion: { "enabled", "maxCharsPerSegment"?, "splitPipeTables"?, "splitDenseParagraphs"?, "maxLinesPerParagraphChunk"?, "splitLongLists"?, "maxListItemsPerChunk"?, "qualityRetrySplit"?, "maxQualityRetrySplitDepth"? }. Wenn enabled true ist (Standard, wenn segmentSplitting weggelassen wird), werden dichte Absätze, GFM-Pipe-Tabellen (der erste Block enthält Kopfzeile, Trennzeichen und die erste Datenzeile) und lange Listen aufgeteilt; Unterteile werden mit einzelnen Zeilenumbrüchen (tightJoinPrevious) wieder zusammengeführt. Setzen Sie "enabled": false, um nur ein Segment pro durch Leerzeilen getrennten Textblock zu verwenden. Wenn qualityRetrySplit true ist (Standard), werden Markdown-Segmente, die nach dem Stoppen der Modellliste die AST-Validierung nicht bestehen, schrittweise aufgeteilt und vom ersten Modell aus erneut versucht. Die Liste stoppt frühzeitig, wenn derselbe Qualitätsfehler dreimal aufgetreten ist. maxQualityRetrySplitDepth (Standard 3) begrenzt rekursive Aufteilungen.
  • warnMarkdownSourceIssues Wenn true (Standard, wenn weggelassen), scannt jeder translate-docs-Lauf Markdown-Segmente nach riskanten Trennzeichen / nicht geschlossenem Inline-Code, gibt Terminalwarnungen aus und ersetzt markdown_source_issues-Zeilen für den Cache-Dateipfad dieser Datei. Setzen Sie false, um Warnungen und SQLite-Updates für diesen Block zu überspringen.
  • addFrontmatter Wenn true (Standard, wenn weggelassen), enthalten übersetzte Markdown-Dateien YAML-Schlüssel: translation_last_updated, source_file_mtime, source_file_hash, translation_language, source_file_path, und wenn mindestens ein Segment Modellmetadaten enthält, translation_models (sortierte Liste der Modell-IDs vom aktiven Anbieter). Auf false setzen, um zu überspringen.
  • emphasisPlaceholders Pro docs[]-Block. Wenn true, werden Markdown-Hervorhebungsbegrenzer vor der Übersetzung als Platzhalter maskiert. Standardmäßig true für CJK-Gebietsschemas (zh, ja, ko) und für in rtlLocales aufgeführte Gebietsschemas; ansonsten standardmäßig false. Überschreibbar über CLI --emphasis-placeholders / --no-emphasis-placeholders.
  • rtlLocales Optionales Array von BCP-47-Codes, die für Hervorhebungs-Platzhalter-Standardwerte als RTL behandelt werden (zusammengeführt mit integrierter RTL-Erkennung).

  • protectAttributes Optional. Zusätzliche JSX/HTML-Attributnamen, deren in Anführungszeichen stehende Zeichenkettenwerte nicht an den Übersetzer gesendet werden dürfen. Wird mit integrierten Standardwerten zusammengeführt (class, id, style, src, href, type, data-*, die meisten aria-* usw.). Groß-/Kleinschreibung wird ignoriert. Gilt für:

  • .astro-Analyse-und-Ersetzungs-Extraktion (statische HTML-Tags und String-Literale nach attr= innerhalb von {expression}-Blöcken).

    • MDX-Platzhalter-Extraktion während der Übersetzung von Markdown/Astro-Abschnitten (label, tooltip und aria-label bei großgeschriebenen JSX-Tags sowie TabItem value, falls zutreffend).

Beispiel: "protectAttributes": ["variant", "size"] behält variant="primary" innerhalb von {items.map(...)} unverändert über alle Sprachen hinweg.

Sie können auch normalerweise übersetzbare Attribute (z. B. "title" oder "aria-label") auflisten, wenn deren Werte wortwörtlich aus dem Englischen übernommen werden sollen.

  • protectKeys Optional. Zusätzliche Namen von Objekteigenschaften, deren in Anführungszeichen stehende String-Werte innerhalb von {expression}-Template-Blöcken und MDX-Objektliteralen nicht übersetzt werden dürfen (z. B. label: innerhalb von <Tabs values={[ … ]}>). Wird mit integrierten Standardwerten zusammengeführt (class, key, id, href, src usw.). Groß-/Kleinschreibung wird ignoriert.

Beispiel: "protectKeys": ["slug", "code"] überspringt { slug: 'getting-started', title: 'Getting started' } → nur title wird übersetzt, wenn slug geschützt ist.


Beispiel (docsOutput.style = "flat" — Screenshot-Pfade + optionaler Sprachlisten-Wrapper):

Beispiel für die Nachbearbeitung im flachen Layout (Screenshots + languageListBlock)
json
"docsOutput": {
  "style": "flat",
  "postProcessing": {
    "regexAdjustments": [
      {
        "description": "Per-locale screenshot folders",
        "search": "images/screenshots/[^/]+/",
        "replace": "images/screenshots/${translatedLocale}/"
      }
    ],
    "languageListBlock": {
      "start": "<small id=\"lang-list\">",
      "end": "</small>",
      "separator": " · ",
      "label": "local"
    }
  }
}

json ​

Top-Level-Array von verschachtelten JSON-Übersetzungspipelines. Wird nur verwendet, wenn features.translateJson wahr ist (translate-json oder die JSON-Phase von sync). Siehe JSON.

FeldBeschreibung
descriptionOptionale Anmerkung für CLI / status (wird nicht übersetzt).
contentPathsQuell-.json-Dateien, -Verzeichnisse oder -Globs unter dem Projektstamm. Typische i18next-Namespace-Dateien (public/locales/en/*.json) werden unterstützt: verschachtelte Objekte, Arrays, {{var}}-Interpolation in Zeichenfolgenwerten und unabhängige Plural-Suffixschlüssel (key_one, key_other).
outputPathTemplateErforderlicher Ausgabepfad pro Zielsprache. Platzhalter: {locale}, {LOCALE}, {llocale}, {stem}, {basename}, {extension}, {relativeToSourceRoot}.
targetLocalesOptionaler Teilbereich für diesen Block; andernfalls Stamm-targetLocales.
keyPolicy.modeallowlist, denylist oder both.
keyPolicy.translateKeysPunkt-Pfade / Muster, die eingeschlossen werden sollen, wenn der Modus allowlist oder both ist.
keyPolicy.skipKeysPunkt-Pfade / Muster, die ausgeschlossen werden sollen (Standard-Verweigerungsliste enthält id, slug, href, url, key, code).

svg ​

Pfade und Layout auf oberster Ebene für SVG-Dateien. Die Übersetzung wird nur ausgeführt, wenn features.translateSVG wahr ist (über translate-svg oder die SVG-Phase von sync).

FeldBeschreibung
sourcePathEin oder mehrere Verzeichnisse oder Glob-Muster (z. B. "images/*.svg", "**/icons/*.svg"). Die Muster werden relativ zum Projektstamm aufgelöst und rekursiv nach .svg-Dateien durchsucht.
outputDirStammverzeichnis für die übersetzte SVG-Ausgabe.
style"flat" oder "nested", wenn pathTemplate nicht gesetzt ist.
pathTemplateBenutzerdefinierter SVG-Ausgabepfad. Platzhalter: "{outputDir}", "{locale}", "{LOCALE}", "{llocale}", "{relPath}", "{stem}", "{basename}", "{extension}", "{relativeToSourceRoot}".
localePathLowercaseWenn true, verwenden integrierte flat / nested SVG-Layouts kleingeschriebene Gebietsschema-Abschnitte. Benutzerdefinierte pathTemplate-Werte bleiben unverändert; verwenden Sie {llocale} für klein geschriebene Abschnitte.
forceLowercaseKleinschreibung bei der Übersetzung beim erneuten Zusammensetzen des SVG. Nützlich für Designs, die auf vollständig kleingeschriebenen Beschriftungen basieren.

modelSuggestion (optional) ​

ChrF- und Arena-Gewichtungen sowie eine optionale Qualitätsuntergrenze für suggest-models und den Tab „Modelle“ im Dashboard. Der Index basiert ausschließlich auf Qualität. Wird der Block oder ein Profil weggelassen, behält dieses Profil die integrierten Gewichtungen bei. Der Block wird nicht von --apply oder Konfiguration aktualisieren überschrieben; diese schreiben nur Modell-IDs. Eine veraltete price-Gewichtung in einem Profil wird beim Laden der Konfiguration entfernt.

  • quality – Standard-ChrF 0.55, Arena 0.45, Qualitätsuntergrenze 0.7
  • price – Standard-ChrF 0.55, Arena 0.45, Qualitätsuntergrenze 0.6

Jedes Profilobjekt erfordert chrf und arena. Jeder Wert ist endlich und mindestens 0, und mindestens einer ist größer als 0. Sie werden so normalisiert, dass ihre Summe 1 ergibt, sodass 55 und 45 den Standardwerten entsprechen. qualityFloor ist optional, liegt im Bereich (0, 1] und ist der Anteil des besten ChrF im Kandidatenpool. Modelle unterhalb der Untergrenze, einschließlich aller Modelle ohne ChrF-Messung, werden nach denen sortiert, die diese überschreiten. Die beiden Profile teilen sich dieselbe Standardmischung; sie unterscheiden sich in der Sortierreihenfolge (--quality nach Index, --price nach Pareto-Front) und in der Untergrenze.

json
"modelSuggestion": {
  "quality": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.7 },
  "price": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.6 }
}

glossary ​

FeldBeschreibung
userGlossaryPfad zu einer CSV-Datei mit den Spalten Original language string (oder en), locale, Translation, optional Force und optional Context – eine Zeile pro Quellbegriff und Zielgebietsschema (locale kann für alle Ziele * sein).
autoAddUserEditedToGlossaryWenn true, können Dashboard-Bearbeitungen von UI-Strings automatisch dem Benutzerglossar hinzugefügt werden.
contextFilesOptionale, relativ zum aktuellen Arbeitsverzeichnis liegende Markdown- oder Nur-Text-Dateien (.md, .markdown, .txt) mit Produkt- oder Funktionserklärungen. Werden beim Start des Befehls geladen und in die Benutzeroberfläche, Dokumente, JSON, SVG und Korrekturaufforderungen eingefügt. Legen Sie diese Dateien nicht in docs[].contentPaths ab, es sei denn, Sie möchten sie ebenfalls übersetzen lassen. URLs werden abgelehnt. Der vollständige Text wird an den konfigurierten LLM-Anbieter gesendet und kann in --debug-failed-Protokollen erscheinen – geben Sie keine Geheimnisse oder personenbezogenen Daten an.
contextMaxCharsMaximale Zeichenanzahl des verketteten Kontextdateitextes, der an das Modell gesendet wird (Standard 12000, harte Obergrenze 100000). Überschüssiger Text wird mit einer Warnung abgeschnitten.
labelCheckSkipsOptionale Liste der zu überspringenden gesperrten UI-Label-Prüfungen. Jeder Eintrag enthält term (englischer Glossarbegriff), locales (Zielcodes oder * für jedes Gebietsschema; Standardwert *), optional files (cwd-relative Globs) und optional note. Der Begriff bleibt ein Prompt-Hinweis. Ein Überspringen wird beim nächsten translate-docs-Lauf angewendet.

translate-docs, translate-json und translate-svg übernehmen auch Hinweise von jedem UI-Block, dessen uiGlossary auf true (den Standardwert) gesetzt ist. Dadurch werden Übersetzungen wiederverwendet, die bereits im strings.json dieses Blocks gespeichert sind. Setzen Sie uiGlossary für einen Block auf false, um ihn auszuschließen. translate-ui und proofread-ui verwenden diese Kataloge nicht als Hinweise. Kompakte UI-Label-Abkürzungen (Formen mit nachgestelltem Punkt wie Alm. oder kurze Einzeltoken-Komprimierungen wie Size → Tam) werden übersprungen, damit Dokument-Prompts nicht in Richtung erfundener {{…}}-Tokens gelenkt werden. Vollständige Produktbegriffe und nicht abgekürzte UI-Übersetzungen werden weiterhin als Hinweise verwendet.

Die optionale Context-CSV-Spalte enthält Nutzungshinweise in der Ausgangssprache für diesen Begriff (Definition, grammatikalische Verwendung, Produktbedeutung). Sie wird nur aufgenommen, wenn der Begriff der aktuellen Charge entspricht. Das Ändern einer Context-Notiz eines Begriffs oder eines contextFiles-Inhalts macht die gecachten Segmente und Dateiverfolgungszeilen des entsprechenden Gebietsschemas beim nächsten Lauf ungültig, sodass Übersetzungen automatisch aktualisiert werden. Das Ändern nur eines bevorzugten Translation in einer nicht erzwungenen Zeile verwendet weiterhin den vorhandenen Cache, es sei denn, Sie übergeben --force / --force-update. Eine Force-Zeile überspringt nur Segmente, deren Quelle diesen Begriff enthält, wenn der gespeicherte Text die erzwungene Übersetzung noch nicht enthält. Vom Benutzer im Dashboard bearbeitete Cache-Zeilen bleiben erhalten. UI-Kataloge säen auch ein gemeinsames mehrteiliges Präfix als eigenen Begriff, wenn dieses Präfix ein großgeschriebenes Label (mindestens zwei Inhaltswörter) ist und die gemeinsame Übersetzung eine kurze Phrase ohne Platzhalter ist. Die Markdown-Übersetzung erfordert ein UI-Label von zwei bis fünf Wörtern, um seine Katalogübersetzung beizubehalten, wenn die Quelle es als gesamten fettgedruckten oder Inline-Code-Bereich, in einer Überschrift oder in einer Zeile, die nur dieses Label enthält, zitiert. Eine längere fettgedruckte Phrase, die den Begriff lediglich enthält, ist ein Hinweis. Die Großschreibung am Satzanfang innerhalb eines Satzes ist ein Hinweis, sodass die Übersetzung flektiert werden kann (Hindi Cursor account kann zu कर्सर खाते anstatt der Wörterbuchform कर्सर खाता werden). Ein Label mit einem einzelnen Inhaltswort, wie z.B. Sign in, bleibt ein Hinweis. Die Prüfung ignoriert die Groß-/Kleinschreibung. Es erfordert weiterhin die Katalogformulierung als Teilstring, sodass eine grammatisch flektierte Form fehlschlagen kann. Dieser Fehler ist eine Warnung: Das Segment wird geschrieben, mit einem Glossar-Label-Flag im Cache gespeichert und am Ende des Laufs in glossary-review-*.md unter cacheDir aufgeführt. Fügen Sie einen labelCheckSkips-Eintrag hinzu oder übergeben Sie --recheck-glossary-warnings, nachdem Sie es überprüft haben. --force übersetzt markierte Zeilen zusammen mit jedem anderen Segment erneut.

Beispiel:

json
{
  "glossary": {
    "userGlossary": "i18n/glossary.csv",
    "contextFiles": ["i18n/product-context.md", "i18n/billing-feature.md"],
    "contextMaxChars": 12000,
    "labelCheckSkips": [
      {
        "term": "Target language",
        "locales": ["uk"],
        "files": ["website/src/content/docs/docs/transform.md"],
        "note": "Inflected inside a bold phrase"
      }
    ]
  }
}

Ein leeres Glossar im CSV-Format generieren:

bash
ai-i18n-tools glossary-generate

Um contextFiles aus dem Repository zu entwerfen, verwenden Sie den Copy-Paste-Agenten-Prompt in Kontextdatei mit einem KI-Agenten generieren. Siehe Glossar, um zu erfahren, wie Begriffszeilen und Kontextdateien angewendet werden.

Veröffentlicht unter der MIT-Lizenz.