如何将reStructuredText转换为纯文本

Question

我计划使用reStructuredText编写文档，主要目的是生成一些漂亮的超文本标记语言页面。为此，我使用docutils rst2html.py工具。

但是，我可能还需要以简洁的纯文本格式呈现文档，即没有reStructuredText标记，并且仍然在文本输出上执行段落换行和类似的简洁格式。但是，docutils中没有rst2txt.py工具。

有没有一种方法可以将reStructuredText转换成漂亮的纯文本格式，也许可以使用docutils的特殊选项？

Answer 1

Sphinx有一个用于txt输出格式的TextBuilder。我刚试过，它似乎能达到你想要的效果。

但是，它可能有点过时了，因为它不在默认的Makefile中。但它在我相当复杂的文档(150 pdf页)上工作得很好。要使用它，只需将以下目标添加到其中：

text:
    $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) _build/text
    @echo
    @echo "Build finished."

另外，请记住，Sphinx只实现了rst规范的一个子集。

Answer 2

我也看到过，这是通过使用rst2html呈现为html，然后使用命令行html浏览器将html转换为纯文本实现的，例如：

• lynx http://lynx.browser.org
• links http://links.sourceforge.net
• w3m http://w3m.sourceforge.net
• elinks http://elinks.or.cz

这些浏览器中的每一个都有一个命令行开关或类似的命令行开关，用于将其输出呈现为.txt文件，因此您可以创建一个名为'rst2txt‘的两行脚本，如下所示：

rst2html docs.rst docs.html
lynx -dump docs.html > docs.txt