Cómo Traducir Automáticamente tu Blog de Hugo Usando AI

Introducción

Una vez que hemos creado nuestro propio blog, nos gustaría que admita múltiples idiomas. Esto no solo amplía nuestra audiencia, sino que también mejora el rendimiento SEO del blog. Sin embargo, traducir manualmente las publicaciones del blog es una tarea que consume mucho tiempo y es laboriosa, ya que requiere traductores profesionales. Pero con el desarrollo de la AI, las cosas son diferentes ahora; usando AI, puedes traducir fácilmente tu blog a cualquier idioma deseado. Para facilitar esto, creé una herramienta que utiliza AI para automatizar la traducción de tus publicaciones de blog, permitiéndote admitir fácilmente múltiples idiomas.

Puedes encontrar la herramienta en hugo-translator.

Preparación

Antes de comenzar, necesitas preparar lo siguiente:

1. Un blog de Hugo en funcionamiento
2. Entorno Node.js y npm
3. API key de OpenAI (para traducción con AI)
4. Conocimiento básico de operaciones de línea de comandos

Pasos de Implementación

1. Obtener la Herramienta

git clone https://github.com/lxb1226/hugo-translator.git
cd hugo-translator

2. Instalar la Herramienta de Traducción AI

Usaremos la herramienta ai-markdown-translator para traducir archivos Markdown. Primero, instálala globalmente:

npm install -g ai-markdown-translator

3. Configurar Variables de Entorno

Establece la API key de OpenAI:

export OPENAI_API_KEY='your-api-key'

Si no tienes una API key de OpenAI, también puedes usar una API de terceros. Puedes comprar una API key de terceros a través de este enlace. Después, puedes configurar:

export OPENAI_URL='your api url'
export API_KEY='your-api-key'

También puedes agregar esta configuración a tu archivo .bashrc o .zshrc para que tenga efecto permanente.

4. Crear el Script de Traducción

Crea un archivo de script llamado translate-posts.sh para automatizar el proceso de traducción. Este script:

• Detectará automáticamente las publicaciones del blog
• Admitirá traducción multilingüe
• Omitirá las publicaciones ya traducidas
• Proporcionará progreso detallado de traducción y estadísticas

Características clave incluyen:

1. Soporte Multilingüe: Soporte predeterminado para múltiples idiomas, incluyendo inglés, japonés y coreano.
2. Detección Inteligente: Identifica automáticamente idiomas de origen y destino.
3. Actualizaciones Incrementales: Solo traduce contenido nuevo o modificado.
4. Manejo de Errores: Manejo completo de errores y registro.
5. Visualización de Progreso: Visualización en tiempo real del progreso y estado de traducción.

5. Uso

Uso básico:

./translate-posts.sh

Idiomas de destino personalizados:

TARGET_LANGS="en ja ko" ./translate-posts.sh

6. Reglas de Nomenclatura de Archivos

Los archivos traducidos se nombrarán automáticamente según la convención de nomenclatura de internacionalización de Hugo:

• Versión en inglés: post-name.en.md
• Versión en japonés: post-name.ja.md
• Versión en coreano: post-name.ko.md

Referencias

• Documentación Oficial de Soporte Multilingüe de Hugo
• Documentación de la API de OpenAI
• Guía de Uso de ai-markdown-translator
• hugo-translator