Types de fichiers
-
.MD
-
.MARKDOWN
-
.MDX
Options d'importation
-
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.
-
Analyse uniquement la structure de base du Markdown (titres, paragraphes, listes et mise en évidence simple).
-
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.
-
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.
-
Analyse le fichier en tant que MDX : Markdown avec composants JSX, expressions JSX (
{...}) et instructionsimport/exportESM. 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 , 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.
-
-
Démarre un nouveau segment à chaque saut de ligne forcé.
-
Conserve la disposition des espaces et des sauts de ligne dans le document cible.
-
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.
-
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>). -
Lorsque cette option est sélectionnée, les éléments de code sont importés sous forme de balises Phrase TMS uniques.
-
Rend les URL disponibles pour la traduction.
-
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é.
-
Définissez les éléments du fichier à convertir en balises.
-
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.
-
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 .
-
Définissez des paires balise/attribut JSX supplémentaires pour les rendre traduisibles, en utilisant le même format
tag/attributeque le paramètre du filtre HTML. Par exemple,Figure/titlerend l'attributtitletraduisible uniquement sur le composantFigure, tandis quetitle(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. -
Activé par défaut.
Applique les attributs traduisibles par défaut du HTML (par exemple,
altsur<img>,titlesur<a>) aux balises en minuscules ou de type HTML, en plus de ceux indiqués dans . 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 à .Lorsqu'il est désactivé, seuls les attributs indiqués dans sont traduisibles, même sur les balises en minuscules.
-
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 . -
Lorsqu'il est désactivé : Le texte à l'intérieur des composants n'est pas traduisible, sauf si le composant est indiqué dans .
-
-
Une liste de noms de composants séparés par des virgules auxquels s'applique le réglage inverse de .
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 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 .
-
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
importetexportsont toujours exclues de la traduction, quel que soit leur emplacement dans le fichier.