Otomatiskan Lokalisasi AI

Otomatisasi lokalisasi mengubah cara Anda menerjemahkan aplikasi. Paket npm ai-l10n menghadirkan terjemahan bertenaga AI langsung ke dalam alur kerja pengembangan Anda, mendukung file lokalisasi dengan fitur otomatisasi cerdas.

Otomatisasi lokalisasi bertenaga AI dalam tindakan

Mengapa Mengotomatiskan Lokalisasi?

Manajemen terjemahan manual memakan waktu dan rentan terhadap kesalahan. Otomatisasi menyediakan:

• Hemat waktu berjam-jam untuk pekerjaan terjemahan manual dengan otomatisasi bertenaga AI.
• Pastikan konsistensi di semua terjemahan dengan AI yang sadar konteks.
• Integrasikan terjemahan langsung ke dalam pipeline CI/CD Anda.
• Deteksi dan terjemahkan string baru secara otomatis sambil mempertahankan terjemahan yang sudah ada.
• Dukung 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 pemformatan sambil mengadaptasi tanggal dan angka ke lokal target. AI secara cerdas menghindari penerjemahan nama diri, URL, dan istilah teknis.

Deteksi Proyek Cerdas

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

Keamanan Tipe & Pelestarian Format

Mempertahankan tipe data JSON—angka tetap angka, boolean tetap boolean, nilai null tetap dipertahankan. Mendukung bentuk jamak i18next dengan pembuatan akhiran otomatis untuk aturan penjamakan yang kompleks.

Deteksi Kesalahan & Pemotongan Cerdas

Mendeteksi dan mencoba ulang secara otomatis jika placeholder atau pemformatan hilang. Untuk file besar, konten dipecah menjadi potongan yang dapat dikelola sambil tetap menjaga konteks. Mencegah masalah umum pada unggahan AI langsung di mana melebihi ~16.000 karakter menyebabkan hilangnya konten.

Memulai

Instalasi

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

npm install ai-l10n

Konfigurasi API Key

Dapatkan API key gratis Anda 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

Command Line Interface

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 ke dalam pipeline CI/CD Anda dengan mulus menggunakan GitHub Action ai-l10n kami:

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

Hasilkan semua string bentuk jamak yang diperlukan secara otomatis dengan akhiran yang benar untuk bahasa dengan aturan penjamakan yang kompleks (seperti bahasa 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 165+ bahasa dengan tingkat kemahiran yang bervariasi:

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

Deteksi Struktur Proyek

ai-l10n secara otomatis mendeteksi struktur proyek Anda dan menghasilkan terjemahan yang 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: Otomatiskan terjemahan pada setiap commit ke file bahasa sumber Anda agar terjemahan selalu mutakhir.
• Simpan API Key dengan Aman: Gunakan variabel lingkungan atau manajemen rahasia untuk API key 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 menyederhanakan alur kerja lokalisasi Anda dengan AI?