HTML
Traduisez le texte et les attributs HTML en préservant les parties non modifiées de la source et en définissant la langue du document sur la langue cible.
Le HTML intègre le texte lisible dans une structure qui contient aussi des liens, des comportements et des informations d’accessibilité. Le gestionnaire html sélectionne les segments de texte et les attributs descriptifs pris en charge, puis insère leurs traductions dans la source d’origine pour une seule langue cible. Il ne découpe pas une page multilingue en zones distinctes par langue.
Préserver la structure du document d’entrée #
Les documents conservent leur doctype d’origine et leurs éléments explicites. Les fragments restent des fragments : la traduction n’ajoute pas d’éléments englobants <html>, <head> ou <body>. Les commentaires, les attributs non modifiés, les types de guillemets et les espaces situés en dehors des segments traduits restent tels qu’ils figurent dans la source.
Lorsqu’un élément <html> explicite est présent, sa valeur lang est remplacée par la langue cible. S’il n’en possède pas, un attribut lang lui est ajouté. Par exemple, <html lang="en"> devient <html lang="fr"> pour le français. Un fragment sans élément <html> explicite n’en reçoit pas un uniquement pour indiquer la langue.
Par exemple, ce fragment contient du texte visible et du texte destiné à l’accessibilité :
<section>
<h2>Delivery options</h2>
<p>Read the <a href="/delivery">delivery policy</a>.</p>
<img src="/truck.svg" alt="Delivery truck" />
<input placeholder="Enter your address" aria-label="Delivery address" />
</section>Le titre, le paragraphe, le libellé du lien, le texte alternatif de l’image, le texte indicatif du champ de saisie et le libellé ARIA sont pris en charge. La destination du lien et la source de l’image restent des propriétés structurelles. Traduire ce fragment ne crée pas de liens localisés et ne remplace pas les ressources d’image.
Sélection des attributs et des zones #
Les attributs pris en charge nativement comprennent alt et title sur les images, placeholder et title sur les champs de saisie et les zones de texte, certains attributs title, l’attribut content des éléments meta et les attributs de libellé ARIA. Examinez attentivement les métadonnées : sélectionner un attribut par son nom ne garantit pas que toutes ses valeurs sont du texte rédigé. Les règles configurées pour les propriétés des composants permettent d’ajouter des attributs pour des éléments désignés par leur nom.
Le contenu des scripts, des styles, du code préformaté, du code, des formules mathématiques, des éléments template, noscript et textarea est exclu de l’extraction de texte ordinaire. Un élément ignoré peut néanmoins posséder un attribut descriptif pris en charge. Pour le SVG, une sélection dédiée cible les contenus title, desc et text pris en charge, plutôt que de traduire des données de dessin arbitraires.
Le balisage en ligne et les jetons {{...}} sont protégés par des espaces réservés pendant la traduction du texte. La reconstruction les rétablit dans les segments traduits. Vérifiez la structure des éléments du résultat et effectuez le rendu de ses variables avec des valeurs représentatives de l’application.
Réutilisation et résultat préservant la source #
Pour permettre la réutilisation, la source et la cible précédentes doivent présenter des structures de texte et d’espaces réservés correspondantes. Le gestionnaire vérifie leur alignement et peut rejeter une paire ambiguë. Gardez la cible acceptée associée à la révision correspondante de la source, plutôt que de comparer des pages rendues sans rapport entre elles.
Seuls les segments traduits et l’attribut de langue de l’élément <html> explicite changent ; les parties non modifiées de la source sont copiées directement dans le résultat. Le gestionnaire ne nettoie pas le HTML non fiable pour le sécuriser. Maintenez les contrôles de sécurité et de rendu propres à votre application.
Si une imbrication incorrecte conduit l’analyseur à regrouper du texte provenant de balisages sans rapport entre eux, le gestionnaire rejette le document au lieu de produire une cible ambiguë. Corrigez l’imbrication, puis réessayez. Les omissions de balises autorisées en HTML ne nécessitent pas l’ajout d’une structure de document.
Configurer les fichiers HTML dans la CLI ou la GitHub App #
La CLI et la GitHub App déduisent html à partir de .html et .htm. Sélectionnez les fichiers sources dans .lingo/config.json, en excluant les cibles générées des motifs de sélection des sources :
{
"sourceLocale": "en",
"targetLocales": ["fr"],
"files": [
{ "pattern": "pages/en/**/*.html", "format": "html" },
{ "pattern": "pages/en/**/*.htm", "format": "html" }
]
}Pour ces extensions, il est facultatif de préciser explicitement format. Associez le projet à votre organisation et à votre moteur de localisation à l’aide de la configuration de la CLI, ou indiquez le moteur pour la GitHub App. Chaque cible est un fichier distinct pour une langue, par exemple pages/fr/index.html. Le HTML ne prend pas en charge la traduction limitée à certaines clés.
Après récupération, effectuez le rendu du document ou du fragment dans l’application qui l’utilise. Comparez les liens et les attributs non textuels, puis examinez le texte destiné à l’accessibilité ainsi que le texte visible. Si un CMS fournit le HTML, suivez les instructions de sélection des champs et de réécriture propres à son connecteur ; les connecteurs peuvent accepter des entrées différentes, même lorsque leur implémentation intègre le traitement HTML.