initium-translation 0.1.1

Initium tool for PO files translation using Google Translator

Traductor PO

Script ejecutable para traducir archivos PO usando Google Translator.

Instalación

El script traductor-po está disponible como comando ejecutable. Para usarlo globalmente, asegúrate de que ~/.local/bin esté en tu PATH:

# Agregar al PATH (temporal)
export PATH=$PATH:~/.local/bin

# O agregar permanentemente a ~/.bashrc o ~/.zshrc
echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc
source ~/.bashrc

Dependencias

Instala las dependencias necesarias:

pip3 install polib deep-translator

Uso

# Traducir un archivo PO a español (por defecto)
traductor-po archivo.po

# Reemplazar el archivo original (in-place)
traductor-po archivo.po -i

# Especificar idioma de destino
traductor-po archivo.po -t es

# Especificar archivo de salida
traductor-po archivo.po -o archivo_traducido.po

# Sobrescribir traducciones existentes
traductor-po archivo.po -f

# Reemplazar archivo original y sobrescribir traducciones existentes
traductor-po archivo.po -i -f

# Modo verbose (mostrar detalles)
traductor-po archivo.po -v

# Especificar idioma de origen
traductor-po archivo.po -s en -t es

Opciones

• input_file: Archivo PO de entrada (requerido)
• -t, --target-language: Código de idioma de destino (default: es)
• -s, --source-language: Código de idioma de origen (default: auto)
• -o, --output-file: Archivo PO de salida (default: archivo_translated.po)
• -i, --in-place: Reemplazar el archivo original en lugar de crear uno nuevo
• -f, --force: Sobrescribir traducciones existentes
• -v, --verbose: Mostrar información detallada de la traducción

Nota: No puedes usar -i y -o al mismo tiempo.

Ejemplos

# Traducir a español (crea archivo nuevo)
traductor-po i18n/es.po

# Reemplazar el archivo original
traductor-po i18n/es.po -i

# Traducir a inglés desde español (crea archivo nuevo)
traductor-po i18n/es.po -s es -t en -o i18n/en.po

# Reemplazar archivo original y sobrescribir traducciones existentes
traductor-po i18n/es.po -i -f

# Traducir forzando sobrescritura con modo verbose
traductor-po i18n/es.po -f -v

Características

• Preserva el contenido entre llaves {} durante la traducción
• Solo traduce entradas sin traducción existente (a menos que uses -f)
• Valida que el contenido entre llaves se preserve correctamente
• Maneja variaciones de espacios que Google Translator puede agregar