将rst转为html的单个py文件

Question

我有一个用reStructuredText写的博客，每次发布新文章时，我都得手动把它转换成HTML格式。

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

我不想用docutils，因为它太大太复杂了。我想找一个更简单的方法，最好是一个单独的Python文件就能搞定。

Answer 1

Sphinx 是一个用来生成文档的 Python 库，它包含了很多可以在命令行中使用的 restructured text（RST）转换工具。

首先，你需要安装 Sphinx：

$ pip install sphinx

然后可以使用很多 rst2*.py 的辅助工具之一：

$ rst2html.py in_file.rst out_file.html

Answer 2

docutils 是一个可以安装的库。安装它的时候，还会自动安装一些前端工具，这些工具可以把 rest 格式的文件转换成多种格式，包括 html。

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

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

大多数转换工具都会利用 docutils 库来完成这个任务。

Answer 3

看看这个关于修改docutils的说明。你不需要整个docutils才能把rst转换成html，但你确实需要一个读取器、解析器、转换器和写入器。只要稍微努力一下，你可以把这些功能合并成一个文件，利用现有的docutils文件。