Como converter RST para HTML
- Adicione o seu arquivo .RST - arraste-o para a caixa acima ou clique para procurar.
- Converta-o para .HTML em poucos segundos.
- Baixe o seu novo arquivo .HTML.
O que esperar
- Diretivas específicas do Sphinx (
.. toctree::,:ref:,:doc:) só funcionam dentro de uma compilação completa do Sphinx; rodar um projeto Sphinx através dorst2htmlas ignora silenciosamente ou gera erros. - Tanto o
rst2htmlquanto o Pandoc geram um HTML estruturalmente correto, mas visualmente simples - nenhum tema é aplicado; adicione seu próprio CSS ou use o Sphinx para um resultado profissional. - Arquivos RST podem incorporar HTML bruto e scripts via
.. raw:: html; converta apenas arquivos.rstde fontes em que você confia.
Perguntas frequentes
Por que o rst2html falha no meu projeto Sphinx?
O arquivo provavelmente usa diretivas exclusivas do Sphinx, como
toctree ou automodule, que o Docutils não consegue resolver sem o pipeline de compilação completo do Sphinx. Use sphinx-build -b html docs/ _build/html em vez disso.Qual ferramenta produz a saída com melhor aparência?
O Sphinx, porque aplica um tema HTML completo com navegação e busca. A saída do
rst2html e do Pandoc é correta, mas visualmente minimalista.Posso converter HTML de volta para RST?
Não de forma confiável - a conversão é de via única. Mantenha o arquivo
.rst como sua fonte de verdade e regenere o HTML sempre que ele mudar.Qual é a diferença entre Docutils e Sphinx?
O Docutils (
rst2html) processa um único arquivo .rst isoladamente. O Sphinx baseia-se no Docutils e adiciona referências entre arquivos, sumário, suporte a extensões e temas HTML completos para projetos de documentação inteiros.
