Markdown

Traduisez le texte du document et les métadonnées d’en-tête sélectionnées tout en préservant le code, les liens et la structure nécessaire pour réutiliser les formulations approuvées.

Un document Markdown associe du texte explicatif à une structure qui guide la lecture. Le gestionnaire de fichiers md traduit le texte des titres, des paragraphes, des cellules de tableau et des libellés de directives pris en charge, tout en protégeant le code et les destinations des liens. Le résultat reste au format Markdown pour votre moteur de rendu habituel.

Texte et structure protégée #

Par exemple, le libellé du lien peut changer tandis que sa destination et le nom de la fonction restent inchangés :

markdown
---
title: Delivery options
description: Choose how your order arrives.
slug: delivery
---

## Choose delivery

Read the [delivery policy](/policies/delivery) before calling `confirmOrder()`.

Le titre, le texte du paragraphe et le libellé du lien constituent le texte à traduire. La destination du lien et le code en ligne font partie de la structure protégée. Dans le profil de document standard, les blocs de code délimités et le HTML brut sont exclus de l’extraction du texte. Utilisez HTML si la source est un document HTML, ou Markdoc si des balises Markdoc personnalisées font partie du langage du document.

Sélection des métadonnées d’en-tête #

Par défaut, le gestionnaire de fichiers sélectionne title et description. Les autres champs restent inchangés, sauf sélection explicite. Une liste translateFrontmatterFields vide désactive la traduction des métadonnées d’en-tête. Le choix des champs dépend de leur contenu : un titre destiné à la lecture peut être traduit, tandis qu’un slug, un identifiant de composant ou une clé de routage peut devoir rester inchangé.

Les chemins de champs pris en charge permettent de cibler des valeurs imbriquées, y compris les éléments d’une séquence. Sélectionner une table associative ou une séquence inclut toutes les valeurs scalaires qu’elle contient, même imbriquées. Choisissez un chemin précis, comme seo.title, lorsque les champs de routage voisins doivent rester inchangés. Utilisez les options de métadonnées d’en-tête de l’interface choisie pour sélectionner le texte à traduire.

La réutilisation nécessite des documents alignés #

Le gestionnaire compare les unités de texte à la source précédente et à la cible correspondante, puis insère les traductions modifiées dans la structure de la source actuelle. Les formulations existantes ne peuvent être réutilisées que si leur correspondance est claire. Si la source précédente et la cible présentent des structures protégées différentes au sein du texte, la réutilisation peut échouer en raison d’une incompatibilité de structure.

Conservez la révision de la source associée aux formulations approuvées dans la cible. Si la cible a été réorganisée indépendamment, réalignez sa structure sur cette source avant de demander une mise à jour incrémentielle. Générez le résultat avec le processeur Markdown de votre site pour vérifier les constructions propres au dialecte utilisé.

Configurez le document et générez son rendu #

La CLI déduit md à partir de .md. Configurez la sélection des fichiers, les champs de métadonnées d’en-tête et les chemins de sortie dans la configuration de la CLI, ou utilisez GitHub pour la traduction gérée des dépôts. La limitation de la portée aux clés dans la CLI n’est pas disponible pour Markdown.

Générez le rendu du document obtenu avec le processeur Markdown de votre site. Vérifiez ensemble les métadonnées traduites, les liens, les fragments de titres et les exemples de code. Conserver /policies/delivery ne crée pas cette page dans une autre langue. Le guide du contenu statique explique comment relier les chemins de sortie au chargeur du site et aux routes par langue.