Sådan konverterer du RST til HTML
- Tilføj din .RST-fil - træk den ind i boksen ovenfor, eller klik for at gennemse.
- Konverter den til .HTML på få sekunder.
- Download din nye .HTML-fil.
Hvad du kan forvente
- Sphinx-specifikke direktiver (
.. toctree::,:ref:,:doc:) fungerer kun inde i et fuldt Sphinx-build; hvis et Sphinx-projekt køres gennemrst2html, fjernes de lydløst, eller der opstår fejl. - Både
rst2htmlog Pandoc producerer strukturelt korrekt, men visuelt enkel HTML - der anvendes intet tema; tilføj dit eget CSS eller brug Sphinx for et poleret resultat. - RST-filer kan indlejre rå HTML og scripts via
.. raw:: html; konverter kun.rst-filer fra kilder, du har tillid til.
Ofte stillede spørgsmål
Hvorfor fejler rst2html på mit Sphinx-projekt?
Filen bruger sandsynligvis Sphinx-specifikke direktiver som
toctree eller automodule, som Docutils ikke kan løse uden den fulde Sphinx-build-pipeline. Kør sphinx-build -b html docs/ _build/html i stedet.Hvilket værktøj giver det flotteste output?
Sphinx, fordi det anvender et komplet HTML-tema med navigation og søgning. Output fra
rst2html og Pandoc er korrekt, men visuelt minimalt.Kan jeg konvertere HTML tilbage til RST?
Ikke pålideligt - konvertering er envejs. Behold
.rst-filen som din kilde og generer HTML-filen igen, når den ændres.Hvad er forskellen på Docutils og Sphinx?
Docutils (
rst2html) behandler en enkelt .rst-fil isoleret. Sphinx bygger oven på Docutils og tilføjer referencer på tværs af filer, en indholdsfortegnelse, understøttelse af udvidelser og komplette HTML-temaer til hele dokumentationsprojekter.
