MDX
Traduisez le texte des fichiers MDX et les propriétés littérales de composants que vous sélectionnez, tout en préservant les expressions, les imports et la structure des composants.
MDX permet d’intégrer des composants interactifs au texte d’un article. Le gestionnaire de fichiers mdx traduit le texte et les éléments enfants des composants pris en charge tout en conservant leur balisage. Sélectionnez explicitement les propriétés littérales des composants lorsqu’elles contiennent elles aussi du texte visible à la lecture ; les imports et les expressions ne sont pas exécutés pour y rechercher du texte.
Séparer le texte des données des composants #
Par exemple, un encadré possède à la fois un titre visible et une propriété qui définit son comportement :
import Callout from "./Callout";
## Delivery options {#delivery}
<Callout title="Delivery deadline" kind="warning">
Confirm your address before checkout.
</Callout>Le titre et le texte des éléments enfants sont à traduire. kind est une donnée du composant qui doit rester inchangée. title n’est à traduire que si une règle ciblant les propriétés des composants la sélectionne. Une règle limitée à Callout et title est plus sûre que la traduction de tous les attributs portant ce nom dans des composants sans rapport entre eux.
Les propriétés contenant des chaînes littérales sont prises en charge. Une propriété calculée par une expression n’équivaut pas à un message littéral. Les imports, les expressions JavaScript et les blocs de code restent exclus de l’extraction du texte courant. La structure des composants doit toujours être compatible avec le moteur de rendu de l’application.
Métadonnées frontmatter et ancres des titres #
Le gestionnaire de fichiers sélectionne par défaut les métadonnées frontmatter title et description. Fournissez une sélection vide pour laisser ces métadonnées non traduites. La sélection d’une table de correspondance ou d’une séquence inclut ses descendants scalaires ; choisissez donc des chemins précis comme seo.title lorsque les champs de routage voisins doivent rester inchangés. Consultez la configuration de la CLI pour translateFrontmatterFields et translateComponentProps.
Les ancres de titres Docusaurus telles que {#delivery} sont protégées même lorsque le texte des titres change. Le traitement des ancres reconnaît la syntaxe des lignes de titre en dehors des blocs de code délimités et laisse les slugs d’URL inchangés. Vérifiez l’identifiant du titre après rendu ainsi que les liens entrants sur votre site.
Mises à jour et alignement #
Les formulations existantes peuvent être réutilisées lorsque la version précédente de la source et sa traduction présentent des unités de texte correspondantes et une même structure protégée au sein du texte. Si cette correspondance est ambiguë, le gestionnaire peut refuser la réutilisation. Gardez chaque traduction acceptée associée à sa révision source, plutôt que de fournir sans le signaler un document dont la structure ne correspond pas.
Vérifiez les propriétés sélectionnées après reconstruction, y compris les libellés visibles en dehors du texte des éléments enfants, puis compilez le résultat avec le processeur MDX de votre application.
Configurer la traduction MDX #
La CLI déduit mdx à partir de .mdx ; la sélection par clé n’est pas disponible pour ce format. Consultez la configuration de la CLI ou GitHub pour connaître les options de fichiers.
Vérifier le rendu du composant #
Compilez le MDX récupéré avec le processeur que vous utilisez réellement et vérifiez conjointement les propriétés des composants, les ancres, les variables et les exemples de code. La traduction de fichiers MDX préserve un document contenant du JSX ; l’extraction de messages React, elle, repère les appels pris en charge dans le code source de l’application et produit des catalogues. Choisissez le workflow adapté à l’endroit où le message est rédigé.