restructuredtext - 如何将 reStructuredText 转换为纯文本

Question

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

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

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

Answer 1

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

• 猞猁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 仅实现了第一个规范的一个子集。