Automatisiere Lokalisierung mit KI

Die Automatisierung der Lokalisierung verändert, wie du Anwendungen übersetzt. Das ai-l10n npm-Paket bringt KI-gestützte Übersetzungen direkt in deinen Entwicklungsworkflow und unterstützt JSON- und Flutter ARB-Dateien mit intelligenten Automatisierungsfunktionen.

KI-gestützte Automatisierung der Lokalisierung in Aktion

Warum Lokalisierung automatisieren?

Manuelle Übersetzungsverwaltung ist zeitaufwendig und fehleranfällig. Automatisierung bietet:

• Spare Stunden manueller Übersetzungsarbeit mit KI-gestützter Automatisierung.
• Sichere Konsistenz über alle Übersetzungen hinweg mit kontextbewusster KI.
• Integriere Übersetzungen direkt in deine CI/CD-Pipeline.
• Erkenne und übersetze automatisch neue Strings, während bestehende Übersetzungen erhalten bleiben.
• Unterstütze 165+ Sprachen mit kontextbewusster Übersetzungsqualität.

KI-gestützte Funktionen

Das ai-l10n-Paket nutzt fortschrittliche KI, um Übersetzungen in Produktionsqualität zu liefern:

Kontextbewusste Übersetzung

KI versteht den Kontext deiner Strings, bewahrt Platzhalter, HTML-Tags und Formatierungen und passt Daten und Zahlen an die Zielregionen an. Sie vermeidet intelligent die Übersetzung von Eigennamen, URLs und Fachbegriffen.

Intelligente Projekterkennung

Erkennt automatisch Zielsprachen aus deiner Projektstruktur (ordnerbasiert oder dateibasiert). Es ist nicht nötig, Sprachen manuell anzugeben, wenn sie bereits in deinem Projekt vorhanden sind.

Typensicherheit & Formatbewahrung

Bewahrt JSON-Datentypen – Zahlen bleiben Zahlen, Booleans bleiben Booleans, Nullwerte werden beibehalten. Unterstützt i18next-Pluralformen mit automatischer Suffixgenerierung für komplexe Pluralisierungsregeln.

Intelligente Fehlererkennung & Chunking

Erkennt automatisch und versucht es erneut, wenn Platzhalter oder Formatierungen verloren gehen. Bei großen Dateien wird der Inhalt in handhabbare Chunks aufgeteilt, während der Kontext erhalten bleibt. Verhindert Probleme, die häufig bei direkten KI-Uploads auftreten, bei denen das Überschreiten von ~16.000 Zeichen zu einem Verlust von Inhalten führt.

Erste Schritte

Installation

Installiere das ai-l10n-Paket mit npm, yarn oder pnpm:

npm install ai-l10n

API-Schlüssel konfigurieren

Hol dir deinen kostenlosen API-Schlüssel und konfiguriere ihn:

npx ai-l10n config --api-key YOUR_API_KEY

Deine erste Übersetzung

Übersetze deine Lokalisierungsdateien mit einem einfachen Befehl:

# Auto-detect target languages from project structure
npx ai-l10n translate path/to/en.json

# Specify target languages
npx ai-l10n translate path/to/en.json --languages es,fr,de

Nutzungsszenarien

Befehlszeilenschnittstelle

Nutze die CLI für schnelle Übersetzungen mit vollem Zugriff auf Optionen:

npx ai-l10n translate ./locales/en.json \
  --languages es,fr,de,ja,zh-CN \
  --plural \
  --verbose

Programmgesteuerte Nutzung

Integriere Übersetzungen direkt in deine Node.js-Anwendungen:

import { AiTranslator } from 'ai-l10n';

const translator = new AiTranslator();

// Basic translation
const result = await translator.translate({
  sourceFile: './locales/en.json',
  targetLanguages: ['es', 'fr', 'de'],
});

console.log(`Translated to ${result.results.length} languages`);
console.log(`Used ${result.totalCharsUsed} characters`);

CI/CD-Integration

Integriere nahtlos KI-gestützte Übersetzung in deine CI/CD-Pipelines mit unserer ai-l10n GitHub Action:

Erstelle eine Konfigurationsdatei:

// example ai-l10n.config.json
[
  {
    "sourceFile": "./locales/en/common.json",
    "targetLanguages": ["es", "fr", "de"],
    "translateOnlyNewStrings": true
  },
  {
    "sourceFile": "./locales/en/common.json",
    "targetLanguages": ["pl", "ar"],
    "generatePluralForms": true,
    "translateOnlyNewStrings": true
  }
]

Füge deinem GitHub Actions-Workflow hinzu:

name: Auto-translate i18n files

on:
  push:
    branches:
      - main
    paths:
      - 'locales/en/**'
      - 'ai-l10n.config.json'

permissions:
  contents: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: l10n-dev/ai-l10n@v1
        with:
          api-key: ${{ secrets.L10N_API_KEY }}
          config-file: 'ai-l10n.config.json'
          pull-request: false

GitLab CI-Konfiguration mit dem ai-l10n-Batch-Befehl:

# .gitlab-ci.yml
translate:
  stage: deploy
  image: node:20-alpine
  only:
    - main
  changes:
    - locales/en/**/*
    - ai-l10n.config.json
  script:
    - npm install -g ai-l10n
    - npx ai-l10n batch ai-l10n.config.json
  variables:
    L10N_API_KEY: $L10N_API_KEY

Jenkins-Pipeline-Konfiguration mit dem ai-l10n-Batch-Befehl:

// Jenkinsfile
pipeline {
  agent any

  stages {
    stage('Translate') {
      when {
        changeset "locales/en/**"
      }
      steps {
        script {
          sh 'npm install -g ai-l10n'
          withCredentials([string(
            credentialsId: 'l10n-api-key',
            variable: 'L10N_API_KEY'
          )]) {
            sh 'npx ai-l10n batch ai-l10n.config.json'
          }
        }
      }
    }
  }
}

Erweiterte Funktionen

Inkrementelle Updates

Übersetze nur neue Schlüssel, während bestehende Übersetzungen erhalten bleiben:

# Only translate new keys, preserve existing translations
npx ai-l10n translate path/to/en.json --update

Batch-Übersetzung

Übersetze mehrere Dateien gleichzeitig mit einer Konfigurationsdatei:

// example translate-config.json
[
  {
    "sourceFile": "./locales/en/common.json",
    "targetLanguages": ["pl", "ru", "ar"],
    "generatePluralForms": true,
    "translateOnlyNewStrings": true
  },
  {
    "sourceFile": "./locales/en/admin.json",
    "targetLanguages": ["pl", "ru", "ar", "de"]
  }
]

npx ai-l10n batch translate-config.json

i18next Pluralformen

Generiere automatisch alle erforderlichen Pluralform-Strings mit den richtigen Suffixen für Sprachen mit komplexen Pluralisierungsregeln (wie Russisch, Arabisch oder Polnisch):

npx ai-l10n translate ./locales/en.json \
  --languages ru,ar,pl \
  --plural

Flutter ARB-Unterstützung

Vollständige Unterstützung für Flutter Application Resource Bundle-Dateien mit automatischen Metadatenupdates:

npx ai-l10n translate ./lib/l10n/app_en_US.arb \
  --languages es_ES,fr_FR,de

Sprachenunterstützung

l10n.dev unterstützt 165+ Sprachen mit unterschiedlichen Kompetenzniveaus:

• Stark (12 Sprachen): Englisch, Spanisch, Französisch, Deutsch, Chinesisch, Russisch, Portugiesisch, Italienisch, Japanisch, Koreanisch, Arabisch, Hindi
• Hoch (53 Sprachen): Die meisten europäischen und asiatischen Sprachen einschließlich Niederländisch, Schwedisch, Polnisch, Türkisch, Vietnamesisch, Thailändisch und mehr
• Moderat (100+ Sprachen): Breite Palette von Weltsprachen

Projekterkennung

ai-l10n erkennt automatisch deine Projektstruktur und generiert Übersetzungen entsprechend:

Ordnerbasierte Struktur

Organisiere Übersetzungen nach Sprachordnern:

locales/
  en/
    common.json
    errors.json
  es/              # Auto-detected
    common.json
    errors.json
  fr-FR/           # Auto-detected
    common.json

Dateibasierte Struktur

Verwende separate Dateien für jede Sprache:

locales/
  en.json          # Source
  es.json          # Auto-detected
  fr-FR.json       # Auto-detected
  zh-Hans-CN.json  # Auto-detected

Best Practices

• Verwende inkrementelle Updates: Verwende das --update-Flag, um nur neue Strings zu übersetzen, bestehende Übersetzungen zu bewahren und Zeichen zu sparen.
• Integriere mit CI/CD: Automatisiere Übersetzungen bei jedem Commit deiner Quellsprachdateien für immer aktuelle Übersetzungen.
• API-Schlüssel sicher speichern: Verwende Umgebungsvariablen oder Geheimnisverwaltung für API-Schlüssel in CI/CD-Umgebungen.
• Überprüfe gefilterte Inhalte: Überprüfe .filtered-Dateien auf Strings, die aufgrund von Richtlinienverstößen ausgeschlossen wurden.
• Verwende Batch-Konfiguration: Für mehrere Dateien verwende die Batch-Übersetzungskonfiguration, um alle Übersetzungen mit einem einzigen Befehl zu verwalten.

Bereit, deinen Lokalisierungsworkflow mit KI zu optimieren?