KI-Lokalisierung automatisieren

Lokalisierungsautomatisierung verändert die Art und Weise, wie Sie Anwendungen übersetzen. Das ai-l10n npm-Paket bringt KI-gestützte Übersetzung direkt in Ihren Entwicklungsworkflow und unterstützt Lokalisierungsdateien mit intelligenten Automatisierungsfunktionen.

KI-gestützte Lokalisierungsautomatisierung in Aktion

Warum Lokalisierung automatisieren?

Manuelles Übersetzungsmanagement ist zeitaufwendig und fehleranfällig. Automatisierung bietet:

• Sparen Sie Stunden an manueller Übersetzungsarbeit mit KI-gestützter Automatisierung.
• Stellen Sie Konsistenz über alle Übersetzungen hinweg mit kontextbewusster KI sicher.
• Integrieren Sie Übersetzungen direkt in Ihre CI/CD-Pipeline.
• Erkennen und übersetzen Sie automatisch neue Zeichenfolgen, während bestehende Übersetzungen beibehalten werden.
• Unterstützen Sie über 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

Die KI versteht den Kontext Ihrer Zeichenfolgen, bewahrt Platzhalter, HTML-Tags und Formatierungen und passt gleichzeitig Daten und Zahlen an die Ziel-Sprachversionen an. Sie vermeidet intelligent die Übersetzung von Eigennamen, URLs und Fachbegriffen.

Intelligente Projekterkennung

Erkennt automatisch Zielsprachen aus Ihrer Projektstruktur (ordner- oder dateibasiert). Sie müssen Sprachen nicht manuell angeben, wenn sie bereits in Ihrem Projekt vorhanden sind.

Typsicherheit & Formatbeibehaltung

Bewahrt JSON-Datentypen – Zahlen bleiben Zahlen, Booleans bleiben Booleans, Nullwerte bleiben erhalten. Unterstützt i18next-Pluralformen mit automatischer Suffix-Generierung für komplexe Pluralisierungsregeln.

Intelligente Fehlererkennung & Segmentierung

Erkennt automatisch, wenn Platzhalter oder Formatierungen verloren gehen, und führt einen erneuten Versuch durch. Bei großen Dateien wird der Inhalt in handhabbare Segmente aufgeteilt, während der Kontext gewahrt bleibt. Dies verhindert Probleme, die bei direkten KI-Uploads häufig auftreten, wenn das Überschreiten von ca. 16.000 Zeichen zu Inhaltsverlust führt.

Erste Schritte

Installation

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

npm install ai-l10n

API-Schlüssel konfigurieren

Holen Sie sich Ihren kostenlosen API-Schlüssel und konfigurieren Sie ihn:

npx ai-l10n config --api-key YOUR_API_KEY

Ihre erste Übersetzung

Übersetzen Sie Ihre 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

Anwendungsszenarien

Befehlszeilenschnittstelle

Verwenden Sie die CLI für schnelle Übersetzungen mit voller Kontrolle über die Optionen:

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

Programmatische Nutzung

Integrieren Sie die Übersetzung direkt in Ihre 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

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

Erstellen Sie 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
  }
]

Zu Ihrem GitHub Actions-Workflow hinzufügen:

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

Übersetzen Sie nur neue Übersetzungsschlü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

Übersetzen Sie 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

Generieren Sie automatisch alle erforderlichen Pluralform-Zeichenfolgen mit korrekten 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 Metadaten-Updates:

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

Sprachunterstützung

l10n.dev unterstützt über 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
• Mäßig (über 100 Sprachen): Große Auswahl an Weltsprachen

Projektstrukturerkennung

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

Ordnerbasierte Struktur

Organisieren Sie Übersetzungen nach Sprachordnern:

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

Dateibasierte Struktur

Verwenden Sie 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

• Inkrementelle Updates verwenden: Verwenden Sie das --update-Flag, um nur neue Zeichenfolgen zu übersetzen, bestehende Übersetzungen zu bewahren und Zeichen zu sparen.
• In CI/CD integrieren: Automatisieren Sie Übersetzungen bei jedem Commit in Ihre Quellsprachdateien für stets aktuelle Übersetzungen.
• API-Schlüssel sicher speichern: Verwenden Sie Umgebungsvariablen oder Secrets-Management für API-Schlüssel in CI/CD-Umgebungen.
• Gefilterte Inhalte überprüfen: Überprüfen Sie .filtered-Dateien auf Zeichenfolgen, die aufgrund von Inhaltsrichtlinienverstößen ausgeschlossen wurden.
• Batch-Konfiguration verwenden: Verwenden Sie für mehrere Dateien die Batch-Übersetzungskonfiguration, um alle Übersetzungen über einen einzigen Befehl zu verwalten.

Bereit, Ihren Lokalisierungsworkflow mit KI zu optimieren?