将 reStructuredText 解析为 HTML

Question

我正在制作一个框架，让开发人员在其中使用 reStructuredText 描述他们的包。我想将 reStructuredText 解析为 HTML，以便在 GUI 中显示它。

我对出色的 Sphinx 很熟悉，但我从未解析过 reStructuredText。我想像一个函数，它接受一个 reStructuredText 字符串，可能还有几个额外的参数，并返回一个 HTML 字符串。

所以我查看了负责解析 reStructuredText 的 Docutils。我完全不明白如何找到这个功能。网络上的文档参差不齐。 docutils.parsers.rst 模块中的许多函数似乎都是针对文件名的。我没有文件名！我只是在处理字符串。

我尝试创建一个Parser 和一个Document 并使用parse 方法，但我收到一个关于缺少.tab_width 设置的错误。

有人知道如何将 reStructuredText 解析成 HTML 吗？

Answer 1

试试这样的：

>>> from docutils.core import publish_string
>>> publish_string("*anurag*", writer_name='html')

publish_string 接受字符串并输出字符串，或者您可以使用publish_parts 获取 html 文档的特定部分，例如

>>> from docutils.core import publish_parts
>>> print publish_parts("*anurag*", writer_name='html')['html_body']
<p><em>anurag</em></p>