如何将reStructuredText转换为纯文本

Question

我计划使用reStructuredText编写文档,主要目的是生成一些不错的HTML页面.为此,我使用docutils rst2html.py工具.

但是,我可能还需要以漂亮的纯文本格式呈现文档,即没有reStructuredText标记,并且仍然对文本输出执行段落包装和类似的良好格式化.但是,docutils中没有rst2txt.py工具.

有没有办法将reStructuredText转换为漂亮的纯文本格式,可能使用了docutils的特殊选项？

Answer 1

我也通过使用rst2html渲染到html,然后使用命令行html浏览器将html转换为纯文本来完成此操作,例如:

• lynx http://lynx.browser.org
• 链接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

Answer 2

Sphinx有一个用于txt输出格式的TextBuilder.刚尝试过它似乎正在寻找你正在寻找的东西.

但是,它可能有点过时,因为它不在默认的Makefile中.但它在我相当复杂的文档(150页pdf页)上运行良好.要使用它,只需添加以下目标:

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

另外,请记住,Sphinx只实现了第一个规范的子集.