Comment convertir RST en HTML
- Ajoutez votre fichier .RST - déposez-le dans la zone ci-dessus ou cliquez pour parcourir.
- Convertissez-le en .HTML en quelques secondes.
- Téléchargez votre nouveau fichier .HTML.
À quoi s'attendre
- Les directives spécifiques à Sphinx (
.. toctree::,:ref:,:doc:) ne sont résolues qu'au sein d'une génération Sphinx complète ; passer un projet Sphinx parrst2htmlles ignore ou génère des erreurs. - Les sorties de
rst2htmlet Pandoc sont structurellement correctes mais visuellement basiques - aucun thème n'est appliqué ; ajoutez votre propre CSS ou utilisez Sphinx pour un résultat professionnel. - Les fichiers RST peuvent intégrer du HTML brut et des scripts via
.. raw:: html; ne convertissez que des fichiers.rstprovenant de sources de confiance.
Foire aux questions
Pourquoi rst2html échoue-t-il sur mi projet Sphinx ?
Le fichier utilise probablement des directives exclusives à Sphinx comme
toctree ou automodule que Docutils ne peut pas résoudre sans le pipeline de génération complet de Sphinx. Utilisez plutôt sphinx-build -b html docs/ _build/html.Quel outil produit le meilleur rendu visuel ?
Sphinx, car il applique un thème HTML complet avec navigation et recherche. Les sorties de
rst2html et Pandoc sont correctes mais minimalistes visuellement.Puis-je convertir du HTML vers le RST ?
Pas de manière fiable - la conversion est unidirectionnelle. Gardez le fichier
.rst comme source de référence et régénérez le HTML à chaque modification.Quelle est la différence entre Docutils et Sphinx ?
Docutils (
rst2html) traite un seul fichier .rst de manière isolée. Sphinx s'appuie sur Docutils et ajoute des références croisées entre fichiers, une table des matières, la gestion des extensions et des thèmes HTML complets pour des projets de documentation entiers.
