Paramètres d’importation de fichiers

.MD / .MDX - Markdown et MDX (TMS)

Le contenu est traduit de l’anglais par Phrase Language AI.

Types de fichiers

  • .MD

  • .MARKDOWN

  • .MDX

Options d'importation

  • Filtrer 

    Choisissez le dialecte Markdown utilisé par l'analyseur lors de l'importation du fichier. Cela affecte également les caractères automatiquement échappés/non échappés lors de l'importation et de l'exportation.

    • Brut

      Analyse uniquement la structure de base du Markdown (titres, paragraphes, listes et mise en évidence simple).

    • PHP/Python Markdown Extra

      Utilise le dialecte « Extra » de PHP Markdown Extra / Python-Markdown pour analyser le fichier et prend également en charge les tableaux, les listes de définitions, les notes de bas de page, les abréviations et les listes d'attributs.

    • GitHub Flavored Markdown

      Utilise la spécification GitHub Flavored Markdown (GFM) pour analyser le fichier et prend également en charge les tableaux, les listes de tâches, le texte barré et les liens automatiques.

    • MDX

      Analyse le fichier en tant que MDX : Markdown avec composants JSX, expressions JSX ({...}) et instructions import/export ESM. Les tableaux, les listes de tâches, le texte barré et les liens automatiques fonctionnent comme dans GitHub Flavored Markdown (GFM). Les blocs de code indentés et les liens automatiques entre chevrons (<url>) ne sont pas pris en charge, car MDX utilise l'indentation pour imbriquer les composants et n'analyse pas ces structures.

      MDX est une extension de Markdown qui intègre JSX : le contenu peut ainsi contenir des composants et des expressions JavaScript (par exemple, dans une documentation créée avec Docusaurus ou Next.js). Le filtre MDX n'est jamais sélectionné automatiquement : vous devez le choisir dans les paramètres d'importation, aussi bien pour les fichiers .MDX que pour les fichiers .MD contenant de la syntaxe MDX. Le filtre n'est détecté automatiquement ni à partir de l'extension du fichier ni à partir de son contenu.

      Remarque

      La prise en charge de MDX doit être activée pour votre organisation. Si MDX ne figure pas dans la liste Filtre, contactez votre responsable de la relation client ou l'assistance Phrase.

      Important

      Le passage d'un projet existant d'un autre filtre Markdown à MDX modifie la segmentation du contenu. Après ce changement, attendez-vous à une baisse ponctuelle du taux de réutilisation de la mémoire de traduction.

  • Les sauts de ligne forcés créent un nouveau segment 

    Démarre un nouveau segment à chaque saut de ligne forcé.

  • Conserver les espaces blancs 

    Conserve la disposition des espaces et des sauts de ligne dans le document cible.

  • Traiter l’en-tête YAML 

    Traite l'en-tête YAML situé au début du fichier. Lorsque cette option est sélectionnée, les paramètres d'importation .YAML sont appliqués.

  • Importer les blocs de code 

    Extrait le contenu des blocs de code pour la traduction. Avec le filtre MDX, cela s'applique également aux blocs de code délimités imbriqués dans des composants JSX (par exemple, à l'intérieur de <CodeGroup>).

  • Exclure les éléments de code 

    Lorsque cette option est sélectionnée, les éléments de code sont importés sous forme de balises Phrase TMS uniques.

  • Rendre les URL traduisibles

    Rend les URL disponibles pour la traduction.

  • Convertir en balises Phrase TMS 

    Appliquer des expressions régulières pour convertir en balises certains textes.

    Important

    Les problèmes avec les balises sont une cause fréquente d'erreurs d'exportation. Assurez-vous toujours que les balises et la mise en forme sont correctes avant d'exporter des fichiers en effectuant des contrôles d'assurance qualité.

  • Éléments personnalisés (convertis en balises Phrase) 

    Définissez les éléments du fichier à convertir en balises.

  • Blocs à ne pas traduire 

    Définissez les sections du fichier qui ne doivent pas être importées.

    Exemple :

    Nom de l'élément : notrans.

    Code : <notrans>Chrysler</notrans> entered three factory-prepared <notrans>Dodge Shadows</notrans> to the event in 1985. All three vehicles retired in the first day of the three-day <notrans>Olympus</notrans> rally.

    Résultat : Chrysler a engagé trois Dodge Shadows préparées en usine pour l'événement en 1985.Les trois véhicules ont abandonné dès le premier jour du rallye Olympus de trois jours.

  • Caractères à ne pas échapper 

    Une liste de caractères qui ne doivent pas être échappés dans le fichier final (par exemple, #, -, [, <, \, `, ![, ](, :).

    Avec le filtre MDX, < et { sont tous deux échappés par défaut dans le texte traduit : dans le cas contraire, un < ou un { non échappé dans le texte cible rendrait la syntaxe MDX invalide. Ajoutez-les ici uniquement si le caractère brut, non échappé, est spécifiquement requis dans la sortie.

Options spécifiques à MDX

Les quatre options suivantes ne sont disponibles que lorsque MDX est sélectionné dans Filtre.

  • Attributs traduisibles

    Définissez des paires balise/attribut JSX supplémentaires pour les rendre traduisibles, en utilisant le même format tag/attribute que le paramètre Attributs traduisibles du filtre HTML. Par exemple, Figure/title rend l'attribut title traduisible uniquement sur le composant Figure, tandis que title (sans restriction à un composant) le rend traduisible sur toutes les balises.

    Les composants personnalisés (noms de balises commençant par une lettre majuscule, tels que <Figure>) n'ont pas d'attributs traduisibles par défaut ; listez-les donc explicitement ici. Les balises en minuscules ou de type HTML (<img>, <a>, etc.) disposent déjà d'attributs traduisibles par défaut.

  • Importer les attributs traduisibles par défaut

    Activé par défaut.

    Applique les attributs traduisibles par défaut du HTML (par exemple, alt sur <img>, title sur <a>) aux balises en minuscules ou de type HTML, en plus de ceux indiqués dans Attributs traduisibles. Les composants personnalisés ne reçoivent jamais ces valeurs par défaut, quel que soit ce paramètre. Leurs attributs ne sont traduisibles que lorsqu'ils sont ajoutés à Attributs traduisibles.

    Lorsqu'il est désactivé, seuls les attributs indiqués dans Attributs traduisibles sont traduisibles, même sur les balises en minuscules.

  • Rendre les éléments traduisibles par défaut

    Activé par défaut.

    Définit si le texte à l'intérieur d'un composant JSX est traduisible par défaut.

    • Lorsqu'il est activé : Le texte à l'intérieur de tout composant (par exemple, <Tabs>, <Note>) est traduisible, sauf si le composant est indiqué dans Éléments dérogeant à la traduisibilité par défaut.

    • Lorsqu'il est désactivé : Le texte à l'intérieur des composants n'est pas traduisible, sauf si le composant est indiqué dans Éléments dérogeant à la traduisibilité par défaut.

  • Éléments dérogeant à la traduisibilité par défaut

    Une liste de noms de composants séparés par des virgules auxquels s'applique le réglage inverse de Rendre les éléments traduisibles par défaut.

    Pour chaque composant figurant dans cette liste, le paramètre est inversé pour l'ensemble du composant : tout son contenu, y compris les composants imbriqués, suit cette dérogation sans être évalué individuellement. Lorsque cette dérogation rend un composant non traduisible, son contenu est conservé exactement tel qu'il est écrit. Utilisez cette liste pour :

    • exclure quelques composants qui ne contiennent pas de prose (par exemple, CodeGroup, Mermaid) lorsque Rendre les éléments traduisibles par défaut est activé, ou

    • rendre traduisibles quelques composants contenant de la prose lorsque ce paramètre est désactivé.

Comment le contenu JSX est traité

Cela s'applique lorsque MDX est sélectionné dans Filtre.

  • Les balises JSX (<Component>, <Component attr="value" />) ainsi que les noms de balises et d'attributs ne sont jamais traduisibles. Seuls le contenu des éléments et les valeurs d'attributs explicitement configurées sont traduisibles.

  • Les expressions entre accolades ({...}), les expressions JavaScript, les attributs de propagation ({...props}) et les commentaires ({/* comment */}) ne sont jamais traduisibles. Ces éléments sont conservés exactement tels qu’ils sont écrits, qu’ils apparaissent dans des attributs, au sein du texte ou sur une ligne distincte.

  • Les instructions import et export sont toujours exclues de la traduction, quel que soit leur emplacement dans le fichier.

Cet article vous a-t-il été utile ?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.