Automatiza la localización con IA

La automatización de la localización transforma la forma en que traduces aplicaciones. El paquete npm ai-l10n lleva la traducción impulsada por IA directamente a tu flujo de trabajo de desarrollo, soportando archivos de localización con funciones de automatización inteligentes.

Automatización de localización impulsada por IA en acción

¿Por qué automatizar la localización?

La gestión manual de traducciones consume mucho tiempo y es propensa a errores. La automatización ofrece:

• Ahorra horas de trabajo de traducción manual con la automatización impulsada por IA.
• Asegura la consistencia en todas las traducciones con IA consciente del contexto.
• Integra las traducciones directamente en tu flujo de trabajo de CI/CD.
• Detecta y traduce automáticamente nuevas cadenas mientras preservas las traducciones existentes.
• Soporta más de 165 idiomas con calidad de traducción consciente del contexto.

Funciones impulsadas por IA

El paquete ai-l10n utiliza IA avanzada para ofrecer traducciones de calidad de producción:

Traducción consciente del contexto

La IA entiende el contexto de tus cadenas, preservando marcadores de posición, etiquetas HTML y formato mientras adapta fechas y números a las configuraciones regionales de destino. Evita inteligentemente traducir nombres propios, URLs y términos técnicos.

Detección inteligente del proyecto

Detecta automáticamente los idiomas de destino a partir de la estructura de tu proyecto (basada en carpetas o archivos). No es necesario especificar idiomas manualmente si ya existen en tu proyecto.

Seguridad de tipos y preservación de formato

Preserva los tipos de datos JSON: los números siguen siendo números, los booleanos siguen siendo booleanos y los valores nulos se mantienen. Soporta formas plurales de i18next con generación automática de sufijos para reglas de pluralización complejas.

Detección inteligente de errores y fragmentación

Detecta y reintenta automáticamente si se pierden marcadores de posición o formato. Para archivos grandes, divide el contenido en fragmentos manejables manteniendo el contexto. Evita problemas comunes con subidas directas de IA donde exceder los ~16,000 caracteres causa pérdida de contenido.

Primeros pasos

Instalación

Instala el paquete ai-l10n usando npm, yarn o pnpm:

npm install ai-l10n

Configurar clave de API

Obtén tu clave de API gratuita y configúrala:

npx ai-l10n config --api-key YOUR_API_KEY

Tu primera traducción

Traduce tus archivos de localización con un comando simple:

# 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

Escenarios de uso

Interfaz de línea de comandos (CLI)

Usa la CLI para traducciones rápidas con control total sobre las opciones:

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

Uso programático

Integra la traducción directamente en tus aplicaciones Node.js:

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

Integración de CI/CD

Integra sin problemas la traducción impulsada por IA en tus flujos de trabajo de CI/CD con nuestra GitHub Action de ai-l10n:

Crea un archivo de configuración:

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

Añade a tu flujo de trabajo de GitHub Actions:

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

Configuración de GitLab CI usando el comando batch de 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

Configuración de pipeline de Jenkins usando el comando batch de 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'
          }
        }
      }
    }
  }
}

Funciones avanzadas

Actualizaciones incrementales

Traduce solo las nuevas claves mientras preservas las traducciones existentes:

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

Traducción por lotes

Traduce varios archivos a la vez con un archivo de configuración:

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

Formas plurales de i18next

Genera automáticamente todas las cadenas de formas plurales requeridas con los sufijos correctos para idiomas con reglas de pluralización complejas (como ruso, árabe o polaco):

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

Soporte para Flutter ARB

Soporte completo para archivos de Application Resource Bundle de Flutter con actualizaciones automáticas de metadatos:

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

Soporte de idiomas

l10n.dev soporta más de 165 idiomas con diferentes niveles de competencia:

• Fuerte (12 idiomas): Inglés, español, francés, alemán, chino, ruso, portugués, italiano, japonés, coreano, árabe, hindi
• Alto (53 idiomas): La mayoría de los idiomas europeos y asiáticos, incluidos holandés, sueco, polaco, turco, vietnamita, tailandés y más
• Moderado (más de 100 idiomas): Amplia gama de idiomas del mundo

Detección de estructura del proyecto

ai-l10n detecta automáticamente la estructura de tu proyecto y genera traducciones en consecuencia:

Estructura basada en carpetas

Organiza las traducciones por carpetas de idioma:

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

Estructura basada en archivos

Usa archivos separados para cada idioma:

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

Mejores prácticas

• Usa actualizaciones incrementales: Usa la bandera --update para traducir solo las cadenas nuevas, preservando las traducciones existentes y ahorrando caracteres.
• Integra con CI/CD: Automatiza las traducciones en cada confirmación (commit) a tus archivos de idioma fuente para obtener traducciones siempre actualizadas.
• Almacena las claves de API de forma segura: Usa variables de entorno o gestión de secretos para las claves de API en entornos de CI/CD.
• Revisa el contenido filtrado: Revisa los archivos .filtered para ver las cadenas excluidas debido a violaciones de la política de contenido.
• Usa configuración por lotes: Para varios archivos, usa la configuración de traducción por lotes para gestionar todas las traducciones desde un solo comando.

¿Listo para optimizar tu flujo de trabajo de localización con IA?