Formatteur ReStructuredText

Le Formatter ReStructuredText prend le texte source reST et produit soit du HTML, soit une version reST nettoyée. Il analyse une sous-ensemble pratique de la grammaire reST, incluant les titres, listes, blocs de code, hyperliens et directives simples, puis applique une normalisation de l’indentation pour assurer une structure cohérente. Le résultat est déterministe et adapté aux pipelines de publication sans modifier le sens voulu.
Conception : l’outil construit une représentation intermédiaire de l’entrée puis la rend vers la cible choisie. En mode HTML, il émet des éléments sémantiques pour les titres, listes et blocs de code tout en préservant la sémantique des directives lorsque c’est possible. En mode rest, il produit un reST portable qui reste fidèle au contenu original.
Les bénéficiaires incluent les rédacteurs techniques, les ingénieurs documentation et les CI qui exigent des sorties prévisibles. La valeur unique réside dans la génération facultative d’une table des matières, la gestion de références croisées de base, des diagnostics pour les directives non prises en charge ou les problèmes d’indentation, et une mise en forme rapide et automatisée réduisant les éditions manuelles.
Fonctions clés : analyse partielle, normalisation de l’indentation, deux sorties cibles, création facultative de TOC, diagnostics et configuration de la largeur d’enveloppement. Cas d’utilisation : API docs, guides utilisateur, notes de version et tout projet visant à standardiser reST entre équipes.