Blog Translate, traduction de blog optimisée SEO
Traduit un article de blog existant en une ou plusieurs langues cibles. Contrairement à une traduction générique, cette compétence produit un contenu optimisé SEO, prêt à être publié, avec des mots-clés, des balises meta et un formatage culturellement correct localisés.
Références clés
Charger à la demande :
references/translation-rules.md, préservation du format, formats des nombres/dates/devisse par locale, gestion des guillemets, critères de qualité.references/cultural-adaptation.md, profils culturels par locale (DACH, francophone, hispanophone, japonais, personnalisé). Ce fichier est partagé avecblog-localize(ne pas dupliquer).
Workflow
Phase 1 : Analyse de l'entrée
- Lire le fichier source (markdown, MDX ou HTML).
- Détecter automatiquement la langue source. Ordre de préférence :
- Champ
langdu frontmatter. - Attribut HTML
lang. - Analyse du contenu (script, mots courants).
- Champ
- Analyser les langues cibles depuis
--tosous forme de codes ISO 639-1 séparés par des virgules (de,fr,es,ja,pt-BR). Si--toest absent, demander à l'utilisateur une fois : "Vers quelles langues dois-je traduire ? Fournissez les codes ISO 639-1 (ex : de, fr, es, ja, pt-BR)." - Valider chaque code. Rejeter les codes invalides avec une suggestion (
jpdevient "Vouliez-vous direjapour le japonais ?"). Si une langue cible est identique à la langue source, l'ignorer avec un message.
Phase 2 : Analyse du contenu
Extraire la surface traduisible :
- Frontmatter :
title,description,tags,author(uniquement si traduisible, par exemple les étiquettes de rôle, pas les noms de personnes). - Tous les titres (H1, H2, H3).
- Paragraphes du corps.
- Texte
altdes images et contenu<figcaption>. - Contenu des
<text>et<tspan>des graphiques ; préserver tous les attributs SVG (x,y,font-size,fill,transform). - Questions et réponses de la FAQ.
- Texte des capsules de citation.
- Points clés ou résumé.
- Texte des appels à l'action (CTA).
- Texte d'ancrage des liens internes.
Préserver inchangé :
- Structure Markdown et HTML, balises, attributs.
- URL des images, URL des liens, clés du frontmatter.
- Blocs de code (traduire uniquement les commentaires en ligne quand c'est pertinent).
- Marqueurs de zone de liens internes (
[INTERNAL-LINK: ...]). - Noms des organisations sources dans les citations (Gartner, McKinsey, etc.).
- Noms de personnes.
- Blocs de schéma JSON-LD (traduire uniquement les valeurs de chaînes visibles par l'utilisateur).
Identifier les mots-clés principaux et secondaires pour la Phase 3.
Phase 3 : Localisation des mots-clés
Pour chaque langue cible :
- Décider si le mot-clé source est le terme établi sur le marché cible. Si oui (par exemple, "Content Marketing" reste en allemand), le conserver.
- Si un équivalent local a un comportement de recherche réel, le remplacer.
- Appliquer la même logique aux mots-clés secondaires.
- Enregistrer le mapping. L'agent traducteur l'utilise pour mettre à jour le titre, la balise meta description et les titres H2 de manière cohérente.
Phase 4 : Traduction
Lancer l'agent blog-translator (via Task) pour chaque langue cible avec :
- Le contenu source.
- La carte de localisation des mots-clés de la Phase 3.
- Le code de la langue cible.
- Les pointeurs vers
references/translation-rules.mdet le profil culturel dansreferences/cultural-adaptation.mds'il en existe un pour la locale cible.
Exécuter les agents en parallèle lors de la traduction en plusieurs langues.
L'agent retourne l'article entièrement traduit dans le même format que l'entrée.
Phase 5 : Post-traitement
Pour chaque version traduite :
- Ajouter ou mettre à jour le frontmatter de locale :
lang: "de" translatedFrom: "en" translatedDate: "YYYY-MM-DD" slug: "wie-man-ki-slop-vermeidet" - Vérifier l'intégrité structurelle :
- Même nombre de sections H2 et H3 que l'original.
- Toutes les images présentes avec texte alt traduit.
- Tous les graphiques SVG présents avec étiquettes de texte traduites (ajustées en longueur : DE +30 %, FR +15 %, JA -20 %, autres voir
references/translation-rules.md). - Nombre de questions FAQ correspondant.
- Capsules de citation présentes dans chaque H2.
- Enregistrer les fichiers traduits :
Lorsqu'elle est invoquée depuistranslations/ {lang}/{slug-localise}.{ext}blog-multilingual, enregistrer dansmultilingual/{lang}/{slug-localise}.{ext}à la place.
Phase 6 : Garde-fous de qualité de traduction
Analyser la sortie pour détecter les artefacts de traduction automatique avant de signaler la fin :
- Expressions idiomatiques littérales (anglicismes translittérés, non adaptés).
- Ordre des mots non naturel (SOV traduit en SVO dans une langue non SVO, ou l'inverse).
- Phrases en langues mélangées (autres que les emprunts établis).
- Chaînes de nombres, dates ou devises encore dans le format source.
- Chaînes du frontmatter encore dans la langue source.
Signaler chaque problème en ligne (chemin du fichier, numéro de ligne, suggestion de correction). L'agent traducteur doit repasser tout passage signalé avant la livraison.
Phase 7 : Livraison
## Traduction terminée : [Titre original]
### Source
- Langue : [source]
- Fichier : [chemin source]
### Traductions
| Langue | Fichier | Mots-clés adaptés | Statut |
|--------|---------|-------------------|--------|
| de | translations/de/{slug}.md | [N] | ok |
| fr | translations/fr/{slug}.md | [N] | ok |
### Contrôles qualité
- Intégrité structurelle : réussite / échec par langue
- Meta tags localisés : réussite / échec par langue
- Nombres, dates, devises formatés par locale : réussite / échec
- Mots-clés localisés : [N] mots-clés adaptés
- Artefacts de traduction automatique signalés : [N] (voir notes ci-dessus)
### Prochaines étapes
- Exécuter `/blog localize <fichier> --locale <code>` pour une adaptation culturelle approfondie.
- Exécuter `/blog locale-audit translations/` pour vérifier l'exhaustivité.
- Utiliser `/blog multilingual` pour combiner écriture, traduction, localisation, hreflang en une seule commande.
Gestion des erreurs
| Scénario | Action |
|---|---|
| Code de langue non pris en charge | Suggérer le code ISO 639-1 correct |
| La source est identique à une cible | Ignorer avec "La source est déjà en [lang]" |
| Fichier introuvable | Signaler l'erreur avec le chemin suggéré |
| Délai d'attente de l'agent traducteur | Réessayer une fois, puis signaler les résultats partiels |
| Fichier binaire ou non textuel | Signaler l'erreur, suggérer le fichier correct |
Références croisées
- Prochaine étape (approfondissement culturel) :
/blog localize <fichier> --locale <code> - Vérification qualité sur toutes les versions linguistiques :
/blog locale-audit <répertoire> - Pipeline en une commande :
/blog multilingual <sujet> --languages <codes>