用于将rst转换为htm的单个py文件

Question

我有一个用reStructuredText写的博客，当我发表一篇新文章时，我现在必须手动将其转换为HTML。

我正在使用Google App Engine编写一个新的博客系统，需要一个简单的方法将rst转换为HTML。

我不想使用docutils，因为它太大太复杂。有没有一种更简单（理想情况下是单个python文件）的方法可以做到这一点？

Answer 1

看一下hacking docutils的说明。您不需要整个docutils来从rst生成html，但是您需要一个阅读器、解析器、转换器和writer。通过一些努力，您可以将所有这些合并到现有docutils文件中的单个文件中。

Answer 2

Sphinx文档生成器Python库包含许多重构文本（RST）命令行转换器。

安装狮身人面像：

$ pip install sphinx

然后使用许多rst2*.py帮助程序之一：

$ rst2html.py in_file.rst out_file.html

Answer 3

docutils是一个可以安装的库。它还安装前端工具，将rest转换为各种格式，包括html。

• http://docutils.sourceforge.net/docs/user/tools.html#rst2html-py

这是一个可以使用的独立工具。

大多数转换器都会为此利用docutils库。