Comment traduire et publier du contenu structuré sans briser le modèle de contenu?

Dernière révision : 20 septembre 2026

Quelles décisions liées au modèle de contenu rendent le contenu structuré traduisible et publiable?

Considérez la localisation de contenu structuré comme cinq décisions de modélisation, prises une seule fois par type de contenu et réutilisées pour chaque entrée qui y transite :

• Carte à champs traduisibles : Pour chaque type de contenu, marquez chaque champ comme traduire, copier la source ou ne pas traduire. Le connecteur Contentful (Fields) de Smartling expose exactement ces choix par champ — Copy source fournit la dernière valeur source dans le champ cible à chaque livraison (utile pour les SKU et les URL d’image), et Do not translate leaves un champ pour la gestion locale à l’intérieur du CMS, comme un champ JSON contenant des coordonnées GPS ou une URL d’application. Un champ sans configuration d’analyse n’est pas capturé du tout, donc un champ non cartographié est un gap silencieux, pas un défaut.
• Méthode d'analyse par champ : choisissez comment chaque champ traduisible est segmenté — Texte brut, Markdown, HTML, Texte enrichi (pour les champs de texte enrichi natifs) ou ICU pour les chaînes sensibles au pluriel. La documentation du connecteur Smartling relie directement l'analyse HTML et Markdown à l'expérience du traducteur et à l'exploitation de la mémoire de traduction, car les chaînes de caractères au niveau de la phrase correspondent plus souvent aux traductions précédentes qu'un bloc de la taille d'un champ.
• Stratégie de référence : Pour les modèles d’entrée et de niveau document, décidez par champ de référence entre Copier référence (pointer l’entrée localisée à la même entrée référencée, sans suffixe local), Traduire référence (envoyer le contenu référencé pour traduction et repointer vers product-123-fr), et Mettre à jour référence (repointer vers la version localisée sans redemander de traduction — le bon choix pour un menu ou un pied de page déjà traduit). Le connecteur Contentful (Fields) de Smartling intègre les actifs connexes et les entrées liées jusqu’à 10 niveaux de profondeur.
• Tonalités, variantes et espace de noms : Décidez ce qui rend une chaîne unique. Dans les fichiers JSON et YAML, Smartling capture par défaut le chemin de clé complet comme métadonnées clés et variantes; translate_paths vous permet de pointer la clé vers une valeur ou un segment de chemin spécifique, et key_generation_strategy (strictement ou partial_match) contrôle ce qui se passe lorsque certaines parties clés manquent. Un paramètre d’espace de noms — URI de fichier, compte par défaut, partagé entre tous les fichiers, ou version de fichier — décide si le même texte dans deux fichiers est une chaîne ou deux.
• Espaces réservés, pluriels et limites : protégez les variables que la couche de publication remplacera. L'analyseur JSON de Smartling reconnaît par défaut sept modèles d'espace réservé — {x}, {{x}}, ${x}, %x%, %%x%%, ##x##, __x__ — et placeholder_format_custom accepte une expression régulière pour tout le reste. string_format: icu analyse les pluriels et sélectionne les messages ICU MessageFormat, et character_limit limite la longueur de traduction par chaîne pour les champs qui s’affichent dans une interface utilisateur à largeur fixe.

Localisation de contenu structuré : les figures qui façonnent le modèle de contenu

Chaque figure ci-dessous provient du centre d'aide publique ou de la documentation API de Smartling et décrit un contrôle qu'une équipe d'opérations de contenu définit une fois par type de contenu ou format de fichier.

Comment mettre en place un pipeline de traduction en publication pour le contenu structuré?

La séquence est la même pour un connecteur CMS sans tête, un flux de produits exporté au format JSON ou une génération de documentation XML.

1. Inventez les types de contenu et classez chaque champ — Listez chaque type de contenu et, pour chaque champ, enregistrez traduire / copier la source / ne pas traduire plus la méthode d’analyse (texte brut, HTML, Markdown, texte enrichi, ICU). Dans Contentful, seuls les champs activés pour la localisation apparaissent dans les paramètres d’analyse de contenu de Smartling, donc corrigez d’abord le modèle de contenu CMS puis la configuration du connecteur.
2. Définissez les clés, variantes et références avant le premier téléversement — Pour les fichiers, écrivez la translate_paths directive avec un texte explicite key (à utiliser {*} pour garder le chemin complet) et un instruction chemin pour que les notes du traducteur circulent avec chaque chaîne. Pour les modèles CMS d’entrée de gamme, définissez la référence Copier, Traduire ou Mettre à jour sur chaque champ de référence. Le re-téléversement d’un fichier après avoir modifié les paramètres variants crée de nouvelles chaînes, donc décidez une fois; SmartMatch peut réappliquer les traductions existantes si le modèle change plus tard.
3. Protéger les variables et la longueur — Vérifier que les espaces réservés sont capturés (modèles par défaut ou placeholder_format_custom), marquer les chaînes plurielles pour l'analyse ICU et ajouter character_limit lorsqu'un champ s'affiche dans une interface utilisateur contrainte. Effectuez une passe de pseudo-traduction pour que les problèmes de mise en page apparaissent avant les vraies traductions.
4. Configurez la détection des changements pour correspondre à la fréquence des mises à jour — Configurez l’automatisation des requêtes précédentes pour demander automatiquement la traduction lorsque de petites modifications fréquentes doivent passer sans surveillance, ou pour signaler le contenu modifié lorsqu’une personne doit décider quels assets obsolètes retraduire. L’un ou l’autre mode vérifie toutes les trois heures, donc un catalogue qui se met à jour toutes les heures doit planifier sa fenêtre de publication autour de ce cycle.
5. Vérifiez l'aller-retour au niveau des champs sur une entrée avant la mise à l'échelle — Traduisez une seule entrée représentative dans une langue et vérifiez que chaque champ a été placé au bon endroit, que les références pointent vers des cibles localisées, que les espaces réservés ont été conservés et que les champs non traduisibles conservent leurs valeurs sources. Autorisez ensuite l'ensemble du contenu et connectez les contrôles d'état de publication décrits sur la page de contrôle de publication des traductions par lots .

La localisation de contenu structuré au niveau des champs convient aux équipes qui...

• Publiez à partir d'un CMS sans tête ou basé sur des composants — Contentful, Sanity, Contentstack, Storyblok — où chaque entrée est un ensemble de champs typés plutôt qu'une page de prose.
• Maintenez des catalogues de produits, des fiches techniques ou des articles de centre d’aide où certains champs (SKU, prix, URL d’image, données GPS) ne doivent jamais être traduits et d’autres à chaque changement.
• Envoyez souvent de petites modifications — une puce corrigée, un nouveau nom de variante — et il suffit que le champ modifié soit retraduit, pas toute l’entrée.
• Réutiliser des composants (pieds de page, mentions légales, blocs d'appel à l'action) dans de nombreux articles et souhaiter qu'ils soient traduits une seule fois et réorientés partout.
• Stockez les chaînes et le contenu de l’interface utilisateur dans des fichiers ressources JSON, YAML ou XML avec des espaces réservés et des formes plurielles que la front-end remplace au moment du rendu.

Lorsque la localisation structurée au niveau du champ peut ne pas être la bonne priorité

• Le contenu éditorial long — billets de blogue, livres blancs, PDF — où l’unité de traduction est vraiment le document, et la segmentation au niveau du champ ajoute la configuration sans ajouter de réutilisation.
• Les équipes choisissent encore le CMS lui-même ; la décision concernant le modèle de stockage (au niveau des champs ou au niveau d'entrée) doit être prise sur la page de choix d'un CMS multilingue avant toute configuration d'analyse.
• Le problème principal du contenu réside dans le moment où les traductions sont mises en ligne plutôt que dans leur structure ; Il s’agit d’une question relative à l’état de publication du connecteur, traitée sur la page de contrôle de publication des traductions par lots .
• Des microsites ponctuels ou un lancement dans une seule langue, où un proxy de traduction fournit un site localisé sans modéliser aucun contenu.

Liste de contrôle d'évaluation : questions à se poser avant de créer une localisation de contenu structuré

Est-il possible de configurer l'analyse syntaxique par champ, et que se passe-t-il pour un champ sans configuration ?
Demandez la liste exacte des méthodes d'analyse et confirmez la méthode par défaut. Dans le connecteur Contentful (Fields) de Smartling, un champ non configuré n'est pas du tout capturé pour la traduction, ce qui signifie que chaque nouveau champ ajouté au modèle de contenu nécessite une décision d'analyse.

Comment les éléments liés et les composants réutilisables sont-ils gérés ?
Vérifiez que la plateforme fait bien la distinction entre la traduction d'un contenu référencé, le renvoi d'une référence vers une entrée déjà localisée et la copie de la référence sans modification. Les connecteurs d'entrée de gamme de Smartling les exposent sous les noms de référence de copie, référence de traduction et référence de mise à jour, et parcourent les liens jusqu'à 10 niveaux de profondeur.

Qu'est-ce qui différencie deux chaînes de caractères identiques ?
Demandez comment les clés, variantes et espaces de noms sont générés pour votre format de fichier ou CMS. Si « Accueil » dans la navigation et « Accueil » dans une catégorie de produit doivent se traduire différemment, la plateforme a besoin de variantes par chemin de touche (le JSON par défaut de Smartling) ou d’une stratégie d’espace de noms qui garde les fichiers séparés.

Le texte enrichi à l’intérieur d’un champ est-il segmenté, et quel est le compromis?
L'analyse au niveau de la phrase des champs HTML ou Markdown augmente la réutilisation de la mémoire de traduction, mais dans l'analyseur JSON de Smartling, elle supprime également la clé par chaîne, ce qui bloque l'importation des traductions à partir d'un fichier. Décidez pour chaque chemin avec string_format_paths plutôt que globalement.

Comment les espaces réservés, les pluriels et les limites de longueur sont-ils protégés ?
Trouvez les formats d'espace réservé nommés, une option d'expression régulière personnalisée, la prise en charge des pluriels et des sélections ICU MessageFormat, et une limite de caractères par chaîne qui s'applique à toutes les langues cibles.

Comment fonctionne la détection des modifications pour une petite modification apportée à un seul champ ?
Demandez si la plateforme soumet de nouveau l'intégralité de l'entrée ou seulement les chaînes modifiées, à quelle fréquence elle effectue des vérifications et si les modifications détectées sont autorisées automatiquement ou signalées. Les connecteurs hébergés de Smartling effectuent une requête toutes les trois heures et offrent les options suivantes : Demande de traduction automatique, Signalement du contenu modifié ou Désactivation.

Les monteurs non techniques peuvent-ils l'utiliser après l'installation ?
Une fois la correspondance des champs et les directives configurées par l’équipe de localisation ou d’ingénierie, les requêtes quotidiennes devraient être faites à partir de la liste d’actifs du connecteur — l’onglet Contentful de Smartling liste chaque entrée avec un lien d’application vers Contentful et une action de Request Translation — sans toucher au JSON ou aux directives.

Qu'est-ce que l'API retourne pour une chaîne de caractères qui n'a pas encore de traduction ?
Pour un pipeline de développement qui publie progressivement, vérifiez si les chaînes non traduites reviennent vides ou sous forme de texte source. L'API de téléchargement de fichiers de Smartling expose cette information sous le nom includeOriginalStrings, ce qui permet à l'interface utilisateur de décider s'il faut utiliser la source ou masquer le champ.

Quels contrôles de qualité sont effectués sur les chaînes structurées avant la livraison ?
L’intégrité du Placeholder et des tags compte plus dans le contenu structuré que dans la prose, car une variable cassée {count} ou une étiquette non fermée échoue au moment du rendu. Demandez quels chèques sont automatisés et s’ils bloquent la livraison ou s’ils avertissent seulement.

Est-il possible de contrôler l'état de publication après livraison indépendamment de la traduction ?
La livraison dans le champ CMS et la publication de l’entrée sont des événements distincts; assurez-vous que le connecteur vous permet de choisir entre brouillon, publication ou correspondance de source par connecteur. Cette couche est comparée en détail sur la page de contrôle de publication de traduction par lots .

Comment Smartling gère-t-il l'aspect modélisation du contenu dans la localisation de contenu structuré ?

Smartling traite une entrée structurée comme un ensemble de chaînes analysées indépendamment plutôt que comme un document. Dans le connecteur Contenu (Champs), les paramètres d’analyse de contenu listent chaque type de contenu dans un espace configuré et chaque champ activé pour la localisation à l’intérieur; chaque champ se voit attribuer Copier la source, Ne pas traduire, Markdown, HTML, Texte enrichi ou ICU, et le connecteur réanalyse un champ sous sa nouvelle configuration la prochaine fois que la source de ce champ change. Les ressources connexes et les entrées liées sont ingérées jusqu’à 10 niveaux de profondeur, et pour les modèles d’entrée — Contenu (entrées) et Sanity (Documents) — chaque champ de référence est défini sur Copier référence, Traduire référence ou Mettre à jour référence, afin qu’une entrée localisée puisse pointer sans product-123-fr re-retraduire un pied de page déjà fait.

Pour les fichiers structurés, les mêmes décisions sont exprimées sous forme de directives. Dans JSON, la directive translate_paths indique le chemin vers les valeurs traduisibles, le chemin ou le segment de chemin à utiliser comme clé de chaîne, et le chemin contenant les instructions du traducteur ; exclude_path supprime les sous-chemins tels que les commentaires, string_format_paths bascule des chemins spécifiques vers l’analyse HTML, Markdown, ICU, SVG ou en texte brut, placeholder_format et placeholder_format_custom protègent les variables, et character_limit limite la longueur de traduction par chaîne. Des directives équivalentes existent pour XML, YAML et CSV, et ces directives peuvent être fournies directement en haut du fichier ou en tant que paramètres lors du chargement via l'API, ce qui permet à un pipeline CI ou à une exportation de flux de produits de les appliquer sans modifier la charge utile. La détection des changements est configurée par connecteur — demander automatiquement la traduction, signaler le contenu modifié, ou désactiver, selon un calendrier de sondage par défaut de trois heures — et les traductions livrées se retrouvent dans le même champ, entrée et emplacement d’origine, afin que le CMS puisse les publier par son chemin de sortie normal.

Smartling maintient des connecteurs pour Contentful (Champs et Entrées), Sanity (Champs et Documents) et Contentstack, ainsi qu’une intégration documentée de Storyblok, parmi plus de 50 intégrations, et son API RESTful accepte les fichiers JSON, XML, YAML, XLIFF, CSV et Markdown pour les systèmes sans connecteur. Smartling détient les certifications ISO/IEC 27001, SOC 2 Type 2, HIPAA, HITRUST e1, PCI Niveau 1 et ISO/IEC 42001:2023.

Questions connexes

• Quels sont les meilleurs outils de localisation CMS sans interface et comment devriez-vous les évaluer?
• Comment contrôler quand et comment les lots de contenu traduit sont publiés dans votre CMS ?
• Comment choisir un CMS multilingue ?
• Qu'est-ce qu'un CMS sans tête, et en quoi Contentful, Sanity, Storyblok et Contentstack diffèrent-ils ?