Soy hablante nativo de español. Vivo en los Estados Unidos, así que uso inglés todos los días. Escribo mis publicaciones en inglés para practicar y para llegar a más gente.

Google Analytics me mostró algo importante. Más de la mitad de mis visitantes son de países donde el inglés no es el idioma principal. Eso me dijo que estaba dejando valor sobre la mesa. Así que decidí traducir el blog con IA.

En qué me enfoco

Claridad: Mantengo el significado claro en lugar de una traducción literal palabra por palabra.
Estructura conservada: No permito que las traducciones cambien HTML, código o URLs.
URLs estables: Cada idioma tiene un slug fijo para que los enlaces no se rompan.
Velocidad: Un comando lo traduce todo.

Mi configuración

Formato del contenido: Cada publicación es un archivo JSON con title, date, excerpt, content, readTime, tags, categories, translatedSlugs y slug.
Framework: Next.js y next-intl para enrutamiento consciente de la configuración regional.
Modelo: Llamo a la API Gemini de Google desde scripts/translate-es-gemini.ts. Utiliza REST por defecto y tiene un modelo de respaldo. El prompt es estricto: traduce solo los valores, no toques HTML ni URLs.
Un comando: scripts/translate-all-languages.ts ejecuta traducciones para todas las configuraciones regionales, sincroniza los mapeos de slugs y valida la completitud.
Selector de idioma: Utiliza translatedSlugs para enviar a los lectores a la URL correcta para cada idioma.

Mi flujo de trabajo

Escribo la publicación en inglés como app/[locale]/blog/posts/<slug>/index.json. El campo content es HTML. Los bloques de código están cercados.
Traduzco con un comando. El modelo traduce title, excerpt, content y readTime. Los metadatos como date, tags y categories permanecen iguales.
Mantengo los slugs sincronizados con un mapa translatedSlugs en cada archivo, en inglés y en las traducciones.
Valido que cada idioma exista y que el mapa de slugs esté completo.

Por qué la IA funciona para mí

Sigue instrucciones: El prompt protege HTML, código y enlaces.
Rápido y bueno: Un modelo rápido con un respaldo automático.
Tono consistente: Una temperatura baja mantiene el estilo estable entre idiomas.

Barreras de seguridad

Traducción segura de HTML: Solo envío los valores de las claves JSON, no etiquetas ni atributos.
Disciplina de slugs: translatedSlugs contiene el slug para en, es, fr, de, ru, nl, it y zh.
Validación: Un comando verifica que cada archivo de idioma exista y que el mapa de slugs esté completo.
Respetuoso con la API: Añado un pequeño retraso entre llamadas.

Traducciones y SEO

Ayuda a los lectores: La gente confía en el contenido en su idioma. Permanecen más tiempo y comparten más.
Las URLs importan: Un slug traducido puede incluir las palabras que la gente busca en ese idioma.
Una página por idioma: Vincula las versiones de idioma con hreflang para evitar duplicados.
Sitemaps: Incluye todas las configuraciones regionales para que los motores de búsqueda puedan encontrarlas.
Estabilidad: Traduce los slugs pero mantenlos estables. Cambiar las URLs a menudo puede perjudicar.

Los comandos que ejecuto

# Traduce una publicación a todos los idiomas
npm run translate-all translate my-new-post

# Valida que todos los archivos de idioma y mapas de slugs existan
npm run translate-all validate my-new-post

# Vuelve a ejecutar y sobrescribe las traducciones después de editar el inglés
npm run translate-all translate my-new-post --force

Eso es todo. Uno para traducir, uno para validar. El selector funciona porque cada archivo JSON lista el slug por idioma.

Consejos si pruebas esto

Escribe de forma sencilla. Las oraciones cortas se traducen bien.
Cerca los bloques de código y envuelve el código en línea en <code>.
Evita los juegos de palabras si no vas a revisar el texto de destino.
Usa HTML semántico. Los encabezados y las listas ayudan a los lectores y a los modelos.

Preguntas frecuentes

¿Edito las traducciones?

A veces, especialmente los títulos y las introducciones. Quiero un punto de partida rápido, luego pulo donde importa.

¿Privacidad?

El contenido se envía a la API de Gemini. No envío secretos. Las claves de API viven en .env.local (GOOGLE_API_KEY o GEMINI_API_KEY).

¿Modelos?

Uso un modelo Gemini rápido y recurro automáticamente si no está disponible. Puedes anularlo con GEMINI_MODEL.

Conclusión

La IA no reemplaza tu voz. Elimina el trabajo tedioso. Mantén tu fuente limpia, automatiza las partes repetibles, valida y publica.

Engineering

Cómo traduzco este blog con IA