Automatisasi Lokalisasi dengan AI

Automatisasi lokalisasi mengubah cara Anda menerjemahkan aplikasi. Paket npm ai-l10n membawa penerjemahan bertenaga AI langsung ke alur kerja pengembangan Anda, mendukung file JSON dan Flutter ARB dengan fitur otomatisasi yang cerdas.

Automatisasi lokalisasi bertenaga AI dalam aksi

Mengapa Mengotomatiskan Lokalisasi?

Manajemen penerjemahan manual memakan waktu dan rentan terhadap kesalahan. Automatisasi menyediakan:

• Hemat jam kerja penerjemahan manual dengan otomatisasi bertenaga AI.
• Pastikan konsistensi di seluruh terjemahan dengan AI yang sadar konteks.
• Integrasikan terjemahan langsung ke dalam pipeline CI/CD Anda.
• Secara otomatis mendeteksi dan menerjemahkan string baru sambil mempertahankan terjemahan yang ada.
• Dukung lebih dari 165 bahasa dengan kualitas terjemahan yang sadar konteks.

Fitur Bertenaga AI

Paket ai-l10n menggunakan AI canggih untuk memberikan terjemahan berkualitas produksi:

Terjemahan Sadar Konteks

AI memahami konteks string Anda, mempertahankan placeholder, tag HTML, dan format sambil menyesuaikan tanggal dan angka dengan lokal target. Ini secara cerdas menghindari menerjemahkan nama yang tepat, URL, dan istilah teknis.

Deteksi Proyek Cerdas

Secara otomatis mendeteksi bahasa target dari struktur proyek Anda (berbasis folder atau file). Tidak perlu secara manual menentukan bahasa jika sudah ada di proyek Anda.

Keamanan Tipe & Pemeliharaan Format

Mempertahankan tipe data JSON—angka tetap angka, boolean tetap boolean, nilai null dipertahankan. Mendukung bentuk jamak i18next dengan generasi sufiks otomatis untuk aturan pluralisasi kompleks.

Deteksi Kesalahan Cerdas & Chunking

Secara otomatis mendeteksi dan mencoba ulang jika placeholder atau format hilang. Untuk file besar, membagi konten menjadi bagian yang dapat dikelola sambil mempertahankan konteks. Mencegah masalah umum dengan unggahan AI langsung di mana melebihi ~16.000 karakter menyebabkan kehilangan konten.

Memulai

Instalasi

Instal paket ai-l10n menggunakan npm, yarn, atau pnpm:

npm install ai-l10n

Konfigurasi Kunci API

Dapatkan kunci API gratis dan konfigurasikan:

npx ai-l10n config --api-key YOUR_API_KEY

Terjemahan Pertama Anda

Terjemahkan file lokalisasi Anda dengan perintah sederhana:

# 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

Skenario Penggunaan

Antarmuka Baris Perintah

Gunakan CLI untuk terjemahan cepat dengan kontrol penuh atas opsi:

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

Penggunaan Programatik

Integrasikan terjemahan langsung ke dalam aplikasi Node.js Anda:

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`);

Integrasi CI/CD

Integrasikan terjemahan bertenaga AI dengan mulus ke dalam pipeline CI/CD Anda menggunakan ai-l10n GitHub Action:

Buat file konfigurasi:

// 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
  }
]

Tambahkan ke alur kerja GitHub Actions Anda:

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

Konfigurasi GitLab CI menggunakan perintah batch ai-l10n:

# .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

Konfigurasi pipeline Jenkins menggunakan perintah batch ai-l10n:

// 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'
          }
        }
      }
    }
  }
}

Fitur Lanjutan

Pembaruan Inkremental

Terjemahkan hanya kunci baru sambil mempertahankan terjemahan yang ada:

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

Terjemahan Batch

Terjemahkan beberapa file sekaligus dengan file konfigurasi:

// 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

Bentuk Jamak i18next

Secara otomatis menghasilkan semua string bentuk jamak yang diperlukan dengan sufiks yang benar untuk bahasa dengan aturan pluralisasi kompleks (seperti Rusia, Arab, atau Polandia):

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

Dukungan Flutter ARB

Dukungan penuh untuk file Flutter Application Resource Bundle dengan pembaruan metadata otomatis:

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

Dukungan Bahasa

l10n.dev mendukung lebih dari 165 bahasa dengan berbagai tingkat kemahiran:

• Kuat (12 bahasa): Inggris, Spanyol, Prancis, Jerman, Cina, Rusia, Portugis, Italia, Jepang, Korea, Arab, Hindi
• Tinggi (53 bahasa): Sebagian besar bahasa Eropa dan Asia termasuk Belanda, Swedia, Polandia, Turki, Vietnam, Thailand, dan lainnya
• Sedang (100+ bahasa): Berbagai bahasa dunia

Deteksi Struktur Proyek

ai-l10n secara otomatis mendeteksi struktur proyek Anda dan menghasilkan terjemahan sesuai:

Struktur Berbasis Folder

Atur terjemahan berdasarkan folder bahasa:

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

Struktur Berbasis File

Gunakan file terpisah untuk setiap bahasa:

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

Praktik Terbaik

• Gunakan Pembaruan Inkremental: Gunakan flag --update untuk menerjemahkan hanya string baru, mempertahankan terjemahan yang ada dan menghemat karakter.
• Integrasikan dengan CI/CD: Otomatisasi terjemahan pada setiap komit ke file bahasa sumber Anda untuk terjemahan yang selalu terbaru.
• Simpan Kunci API dengan Aman: Gunakan variabel lingkungan atau manajemen rahasia untuk kunci API di lingkungan CI/CD.
• Tinjau Konten yang Difilter: Periksa file .filtered untuk string yang dikecualikan karena pelanggaran kebijakan konten.
• Gunakan Konfigurasi Batch: Untuk beberapa file, gunakan konfigurasi terjemahan batch untuk mengelola semua terjemahan dari satu perintah.

Siap untuk memperlancar alur kerja lokalisasi Anda dengan AI?