So konvertieren Sie RST in HTML
- Fügen Sie Ihre .RST-Datei hinzu - ziehen Sie sie in das Feld oben oder klicken Sie, um zu suchen.
- Konvertieren Sie sie in wenigen Sekunden zu .HTML.
- Laden Sie Ihre neue .HTML-Datei herunter.
Was Sie erwartet
- Sphinx-spezifische Direktiven (
.. toctree::,:ref:,:doc:) werden nur innerhalb eines vollständigen Sphinx-Builds aufgelöst; die Verarbeitung eines Sphinx-Projekts durchrst2htmllässt diese weg oder wirft Fehler. - Sowohl
rst2htmlals auch Pandoc geben strukturell korrektes, aber optisch schlichtes HTML aus - es wird kein Theme angewendet; fügen Sie eigenes CSS hinzu oder nutzen Sie Sphinx für ein professionelles Ergebnis. - RST-Dateien können über
.. raw:: htmlrohes HTML und Skripte einbetten; konvertieren Sie nur.rst-Dateien aus Quellen, denen Sie vertrauen.
Häufig gestellte Fragen
Warum schlägt rst2html bei meinem Sphinx-Projekt fehl?
Die Datei verwendet wahrscheinlich Sphinx-exklusive Direktiven wie
toctree oder automodule, die Docutils ohne die vollständige Sphinx-Build-Pipeline nicht auflösen kann. Verwenden Sie stattdessen sphinx-build -b html docs/ _build/html.Welches Tool liefert das optisch beste Ergebnis?
Sphinx, da es ein vollständiges HTML-Theme mit Navigation und Suche anwendet. Die Ausgabe von
rst2html und Pandoc ist korrekt, aber visuell minimalistisch.Kann ich HTML zurück in RST konvertieren?
Nicht zuverlässig - die Konvertierung ist eine Einbahnstraße. Behalten Sie die
.rst-Datei als Ihre „Source of Truth“ und generieren Sie das HTML bei Änderungen neu.Was ist der Unterschied zwischen Docutils und Sphinx?
Docutils (
rst2html) verarbeitet eine einzelne .rst-Datei isoliert. Sphinx baut auf Docutils auf und ergänzt dateiübergreifende Referenzen, Inhaltsverzeichnisse, Erweiterungs-Support und vollständige HTML-Themes für komplette Dokumentationsprojekte.
