Traducir Documento

El comando doc translate traduce automáticamente archivos de documentación desde un locale base a locales destino usando servicios de traducción AI.

Puntos clave:

• Divide archivos markdown grandes en fragmentos para mantenerse dentro de los límites de la ventana de contexto del modelo de IA.
• Reintenta la traducción si el formato de salida es incorrecto.
• Incorpora contexto específico de la aplicación y del archivo para mejorar la precisión de la traducción.
• Preserva las traducciones existentes al no sobrescribirlas.
• Procesa archivos, fragmentos y locales en paralelo usando un sistema de cola para aumentar la velocidad.

npx intlayer doc translate

Argumentos:

Opciones de lista de archivos:

• --doc-pattern [docPattern...]: Patrones glob para coincidir con archivos de documentación a traducir.

  Ejemplo: npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"

• --excluded-glob-pattern [excludedGlobPattern...]: Patrones glob para excluir archivos de la traducción.

  Ejemplo: npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"

• --skip-if-modified-before [skipIfModifiedBefore]: Omitir el archivo si ha sido modificado antes del tiempo dado.

  • Puede ser un tiempo absoluto como "2025-12-05" (string o Date)
  • Puede ser un tiempo relativo en ms 1 * 60 * 60 * 1000 (1 hora)
  • Esta opción verifica la hora de actualización del archivo usando el método fs.stat. Por lo tanto, podría verse afectada por Git u otras herramientas que modifiquen el archivo.

  Ejemplo: npx intlayer doc translate --skip-if-modified-before "2025-12-05"

• --skip-if-modified-after [skipIfModifiedAfter]: Omitir el archivo si ha sido modificado dentro del tiempo dado.

  • Puede ser un tiempo absoluto como "2025-12-05" (string o Date)
  • Puede ser un tiempo relativo en ms 1 * 60 * 60 * 1000 (1 hora)
  • Esta opción verifica la hora de actualización del archivo usando el método fs.stat. Por lo tanto, podría verse afectada por Git u otras herramientas que modifiquen el archivo.

  Ejemplo: npx intlayer doc translate --skip-if-modified-after "2025-12-05"

• --skip-if-exists: Omitir el archivo si ya existe.

  Ejemplo: npx intlayer doc translate --skip-if-exists

Opciones de salida de entrada:

• --locales [locales...]: Locales de destino para traducir la documentación.

  Ejemplo: npx intlayer doc translate --locales fr es de

• --base-locale [baseLocale]: Locale de origen desde el cual traducir.

  Ejemplo: npx intlayer doc translate --base-locale en

Opciones de procesamiento de archivos:

• --nb-simultaneous-file-processed [nbSimultaneousFileProcessed]: Número de archivos a procesar simultáneamente para la traducción.

  Ejemplo: npx intlayer doc translate --nb-simultaneous-file-processed 5

Opciones de IA:

• --model [model]: El modelo de IA a usar para la traducción (por ejemplo, gpt-3.5-turbo).
• --provider [provider]: El proveedor de IA a usar para la traducción.
• --temperature [temperature]: Configuración de temperatura para el modelo de IA.
• --api-key [apiKey]: Proporciona tu propia clave API para el servicio de IA.
• --application-context [applicationContext]: Proporciona contexto adicional para la traducción de IA.
• --data-serialization [dataSerialization]: El formato de serialización de datos a utilizar para las funciones de IA de Intlayer. Opciones: json (estándar, confiable), toon (menos tokens, menos consistente).

• --custom-prompt [prompt]: Personaliza el prompt base utilizado para la traducción. (Nota: Para la mayoría de los casos, se recomienda usar la opción --custom-instructions en su lugar, ya que proporciona un mejor control sobre el comportamiento de la traducción.)

  Ejemplo: npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Mi aplicación es una tienda de gatos"

Opciones de variables de entorno:

• --env: Especifica el entorno (por ejemplo, development, production).
• --env-file [envFile]: Proporciona un archivo de entorno personalizado para cargar variables.
• --base-dir: Especifica el directorio base para el proyecto.

• --no-cache: Desactiva la caché.

  Ejemplo: npx intlayer doc translate --base-dir ./docs --env-file .env.production.local

Opciones de registro:

• --verbose: Habilita el registro detallado para depuración. (por defecto es true usando CLI)

  Ejemplo: npx intlayer doc translate --verbose

Opciones de instrucciones personalizadas:

• --custom-instructions [customInstructions]: Instrucciones personalizadas añadidas al prompt. Útil para aplicar reglas específicas respecto al formato, traducción de URLs, etc.

  • Puede ser un tiempo absoluto como "2025-12-05" (string o Date)
  • Puede ser un tiempo relativo en ms 1 * 60 * 60 * 1000 (1 hora)
  • Esta opción verifica la fecha de actualización del archivo usando el método fs.stat. Por lo tanto, podría verse afectada por Git u otras herramientas que modifiquen el archivo.

  Ejemplo: npx intlayer doc translate --custom-instructions "Evitar traducir URLs y mantener el formato markdown"

  Ejemplo: npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"

Opciones de Git:

• --git-diff: Ejecutar solo en diccionarios que incluyan cambios desde la base (por defecto origin/main) hasta la rama actual (por defecto: HEAD).
• --git-diff-base: Especificar la referencia base para git diff (por defecto origin/main).
• --git-diff-current: Especificar la referencia actual para git diff (por defecto: HEAD).
• --uncommitted: Incluir cambios no confirmados.
• --unpushed: Incluir cambios no enviados.

• --untracked: Incluir archivos no rastreados.

  Ejemplo: npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD

  Ejemplo: npx intlayer doc translate --uncommitted --unpushed --untracked

Tenga en cuenta que la ruta del archivo de salida se determinará reemplazando los siguientes patrones

• /{{baseLocale}}/ por /{{locale}}/ (Unix)
• {{baseLocale}}` por {{locale}}` (Windows)
• _{{baseLocale}}. por _{{locale}}.
• {{baseLocale}}_ por {{locale}}_
• .{{baseLocaleName}}. por .{{localeName}}.

Si no se encuentra el patrón, el archivo de salida añadirá .{{locale}} a la extensión del archivo. ./my/file.md se traducirá a ./my/file.fr.md para el locale francés.