Come convertire RST in HTML
- Aggiungi il tuo file .RST - trascinalo nel riquadro sopra o fai clic per sfogliare.
- Convertilo in .HTML in pochi secondi.
- Scarica il tuo nuovo file .HTML.
Cosa aspettarsi
- Le direttive specifiche di Sphinx (
.. toctree::,:ref:,:doc:) si risolvono solo all'interno di una compilazione Sphinx completa; l'esecuzione di un progetto Sphinx tramiterst2htmlle ignora silenziosamente o genera errori. - Sia
rst2htmlche Pandoc producono un HTML strutturalmente corretto ma visivamente semplice - non viene applicato alcun tema; aggiungi il tuo CSS o usa Sphinx per un risultato rifinito. - I file RST possono incorporare HTML grezzo e script tramite
.. raw:: html; converti solo file.rstda fonti di cui ti fidi.
Domande frequenti
Perché rst2html fallisce sul mio progetto Sphinx?
Il file probabilmente utilizza direttive solo per Sphinx come
toctree o automodule che Docutils non può risolvere senza l'intera pipeline di compilazione di Sphinx. Esegui invece sphinx-build -b html docs/ _build/html.Quale strumento produce l'output esteticamente migliore?
Sphinx, perché applica un tema HTML completo con navigazione e ricerca. L'output di
rst2html e Pandoc è corretto ma visivamente minimale.Posso riconvertire l'HTML in RST?
Non in modo affidabile - la conversione è unidirezionale. Mantieni il file
.rst come tua fonte di verità e rigenera l'HTML ogni volta che cambia.Qual è la differenza tra Docutils e Sphinx?
Docutils (
rst2html) elabora un singolo file .rst in isolamento. Sphinx si basa su Docutils e aggiunge riferimenti incrociati tra file, un indice, supporto per estensioni e temi HTML completi per progetti di documentazione interi.
