Nous publions dans plusieurs langues sans ralentir l'écriture. Notre approche est simple : écrire une fois en anglais, puis traduire de manière fiable avec Gemini, tout en conservant la structure, les liens et les blocs de code intacts.

Ce que nous optimisons

Précision : Signification technique claire plutôt que traduction mot à mot.
Structure préservée : Conserver le HTML, le code et les liens intacts.
URL cohérentes : Slugs stables par langue pour que les liens ne soient jamais rompus.
Vitesse : Traduire toutes les langues avec une seule commande.

La pile (en un coup d'œil)

Format du contenu : Chaque article est un fichier JSON avec title, date, excerpt, content, readTime, tags, categories, translatedSlugs et slug.
Framework : Next.js + next-intl pour le routage sensible à la locale.
Gemini : Nous appelons l'API Gemini via un petit script Node (scripts/translate-es-gemini.ts). Il utilise REST par défaut, prend en charge un modèle de secours et applique : « traduire uniquement les valeurs, ne pas toucher au HTML ou aux URL ».
Orchestration en une seule commande : scripts/translate-all-languages.ts exécute chaque traduction par locale, puis normalise les mappages de slugs et valide l'exhaustivité.
Sélecteur de langue dynamique : Il lit les translatedSlugs par article, de sorte que le changement de langue atterrit toujours sur la bonne URL.

Comment cela fonctionne de bout en bout

Écrire en anglais : Créez app/[locale]/blog/posts/<slug>/index.json avec votre contenu. Utilisez du HTML propre dans content et conservez les blocs de code entre guillemets.
Traduire : Exécutez une commande (exemples ci-dessous). En coulisses, nous appelons Gemini pour title, excerpt, content et readTime. Les métadonnées comme date, tags et categories restent telles quelles.
Normaliser les slugs : Nous conservons une carte translatedSlugs dans chaque fichier (anglais et traductions). Le sélecteur de langue s'appuie sur elle pour passer d'une langue à l'autre.
Valider : Une vérification rapide confirme que chaque fichier de langue existe et qu'une carte translatedSlugs complète est présente.

Pourquoi Gemini convient à ce travail

Respect des instructions : Notre invite est stricte : « traduire uniquement les valeurs, préserver le HTML/code/liens ». C'est essentiel pour un rendu sûr.
Équilibre entre vitesse et qualité : Nous utilisons par défaut un modèle rapide et nous rabattons automatiquement si un nom de modèle change.
Suffisamment déterministe : Une température basse maintient un ton cohérent entre les articles.

Garde-fous que nous avons ajoutés

Traductions HTML sûres : Le script n'envoie que les valeurs des clés JSON. Il ne laisse jamais le modèle réécrire les balises ou les attributs.
Discipline des slugs : translatedSlugs liste le slug de l'article par langue (par exemple, en, es, fr, de, ru, nl, it, zh). Notre sélecteur de langue utilise cette source de vérité.
Validation : Une commande vérifie que chaque fichier de langue existe et que la carte des slugs est complète.
Respect des limites de débit : Nous ajoutons un petit délai entre les requêtes pour être respectueux de l'API.

Flux de travail du développeur

# Traduire un article dans toutes les langues
npm run translate-all translate mon-nouvel-article

# Valider que tous les fichiers de langue et les cartes de slugs existent
npm run translate-all validate mon-nouvel-article

# Relancer et écraser les traductions si vous avez modifié l'anglais
npm run translate-all translate mon-nouvel-article --force

C'est tout. Une commande pour traduire, une pour valider. Le sélecteur de langue fonctionne simplement car il recherche les slugs par langue que nous maintenons dans chaque fichier JSON.

Conseils pour de meilleurs résultats

Écrivez clairement. Les phrases courtes et directes se traduisent mieux.
Gardez les blocs de code entre guillemets et le code en ligne enveloppé dans <code>.
Évitez les idiomes et les blagues, sauf si vous êtes prêt à ajuster le texte cible.
Privilégiez le HTML sémantique. Les titres et les listes aident les lecteurs et les modèles.

FAQ

Modifiez-vous les traductions ?

Oui, lorsque la nuance est importante (titres, introductions). L'objectif est de commencer rapidement avec une ébauche solide, puis de peaufiner si nécessaire.

Confidentialité ?

Les traductions sont envoyées à l'API Gemini. N'incluez pas de secrets dans les articles. Nous conservons les identifiants dans .env.local (GOOGLE_API_KEY ou GEMINI_API_KEY).

Modèles ?

Nous utilisons par défaut un modèle Gemini rapide et nous rabattons automatiquement s'il n'est pas disponible. Vous pouvez le remplacer via GEMINI_MODEL.

Conclusion

Un excellent contenu multilingue ne doit pas être lent. Gardez votre source propre, automatisez les tâches fastidieuses, validez et livrez.

Engineering

Comment nous utilisons Gemini pour traduire notre blog (rapidement, de manière cohérente, de manière conviviale)