Hvordan konvertere RST til HTML
- Legg til din .RST-fil - slipp den i boksen over eller klikk for å bla gjennom.
- Konverter den til .HTML i løpet av noen få sekunder.
- Last ned din nye .HTML-fil.
Hva du kan forvente
- Sphinx-spesifikke direktiver (
.. toctree::,:ref:,:doc:) fungerer kun i en full Sphinx-bygging; å kjøre et Sphinx-prosjekt gjennomrst2htmlvil fjerne dem eller gi feilmeldinger. - Både
rst2htmlog Pandoc produserer strukturelt korrekt, men visuelt enkel HTML - ingen tema blir lagt til; legg til din egen CSS eller bruk Sphinx for et profesjonelt resultat. - RST-filer kan bygge inn rå HTML og skript via
.. raw:: html; konverter kun.rst-filer fra kilder du stoler på.
Ofte stilte spørsmål
Hvorfor feiler rst2html på mitt Sphinx-prosjekt?
Filen bruker sannsynligvis Sphinx-eksklusive direktiver som
toctree eller automodule som Docutils ikke kan tolke uten Sphinx sin byggerekke. Kjør sphinx-build -b html docs/ _build/html i stedet.Hvilket verktøy produserer det peneste resultatet?
Sphinx, fordi det bruker et komplett HTML-tema med navigasjon og søk. Utdata fra
rst2html og Pandoc er korrekt, men visuelt minimalistisk.Kan jeg konvertere HTML tilbake til RST?
Ikke pålitelig - konverteringen er enveis. Behold
.rst-filen som din kilde og generer HTML-en på nytt hver gang den endres.Hva er forskjellen mellom Docutils og Sphinx?
Docutils (
rst2html) behandler en enkelt .rst-fil isolert. Sphinx bygger på Docutils og legger til kryssreferanser mellom filer, innholdsfortegnelser, støtte for utvidelser og komplette HTML-temaer for hele dokumentasjonsprosjekter.
