Un diff lisible, ligne pour ligne
Comme le nombre de lignes et les marqueurs sont préservés, la comparaison avec l’original met en évidence le texte traduit et rien d’autre.
Traduire le texte rédigé d’un fichier Markdown
Traduction de fichiers Markdown : frontmatter intact, blocs de code intacts, marqueurs de structure conservés. Liens et images protégés pendant la traduction.
Déposez votre fichier, ou choisissez-le
Markdown avec ou sans frontmatter YAML ou TOML.
Le fichier n’est envoyé qu’au moment où vous lancez l’analyse. Il est supprimé après traitement.
Comme le nombre de lignes et les marqueurs sont préservés, la comparaison avec l’original met en évidence le texte traduit et rien d’autre.
Le code en ligne, les images, les URL brutes, le HTML inline et les variables de gabarit sont masqués avant traduction, puis remis en place.
Traduire un identifiant, une date ou une liste d’étiquettes dans le frontmatter casserait la génération du site. Il est donc exclu du périmètre.
## Installation rapide
Installez le paquet, puis lancez la commande :
```bash
npm install mon-paquet
``` ## Quick install
Install the package, then run the command:
```bash
npm install mon-paquet
``` Les exemples de commandes et de code restent exécutables, ce qui est la première exigence d’une documentation technique.
Le frontmatter conserve la date, les étiquettes et l’identifiant ; vous ajustez ensuite le titre et l’adresse.
Badges, liens et extraits de code sont préservés ; seul le texte explicatif change.
Le diff ligne par ligne permet une revue par pull request, segment par segment.
Non, délibérément. Le frontmatter est restitué octet pour octet, car il contient aussi des identifiants, des dates et des chemins qu’une traduction casserait. Modifiez-y le titre et la description à la main après coup.
Les blocs délimités par trois accents graves ou trois tildes, ainsi que les blocs indentés de quatre espaces, sont ignorés par l’extraction : leur contenu ne quitte jamais le fichier.
Le découpage suit les constructions courantes décrites par CommonMark, étendues aux tableaux et aux cases à cocher d’usage répandu. Les directives propres à un générateur particulier ne sont pas garanties.