Hoe RST naar HTML te converteren
- Voeg uw .RST-bestand toe - sleep het in het bovenstaande vak of klik om te bladeren.
- Converteer het naar .HTML in enkele seconden.
- Download uw nieuwe .HTML-bestand.
Wat u kunt verwachten
- Sphinx-specifieke richtlijnen (
.. toctree::,:ref:,:doc:) werken alleen binnen een volledige Sphinx-build; het verwerken van een Sphinx-project viarst2htmllaat deze stilletjes vallen of geeft foutmeldingen. - Zowel
rst2htmlals Pandoc produceren structureel correcte maar visueel eenvoudige HTML - er wordt geen thema toegepast; voeg uw eigen CSS toe of gebruik Sphinx voor een gepolijst resultaat. - RST-bestanden kunnen ruwe HTML en scripts bevatten via
.. raw:: html; converteer alleen.rst-bestanden van bronnen die u vertrouwt.
Veelgestelde vragen
Waarom faalt rst2html op mijn Sphinx-project?
Het bestand gebruikt waarschijnlijk richtlijnen die alleen voor Sphinx zijn, zoals
toctree of automodule, die Docutils niet kan verwerken zonder de volledige Sphinx-build-pipeline. Voer in plaats daarvan sphinx-build -b html docs/ _build/html uit.Welke tool produceert de mooiste uitvoer?
Sphinx, omdat het een volledig HTML-thema toepast met navigatie en zoekfunctie. Uitvoer van
rst2html en Pandoc is correct maar visueel minimaal.Kan ik HTML terug converteren naar RST?
Niet betrouwbaar - conversie is eenrichtingsverkeer. Houd het
.rst-bestand aan als uw bron en genereer de HTML opnieuw wanneer deze verandert.Wat is het verschil tussen Docutils en Sphinx?
Docutils (
rst2html) verwerkt een enkel .rst-bestand op zichzelf. Sphinx bouwt voort op Docutils en voegt verwijzingen tussen bestanden, een inhoudsopgave, ondersteuning voor extensies en volledige HTML-thema's toe voor complete documentatieprojecten.
