我计划使用reStructuredText编写文档,主要目的是生成一些漂亮的HTML页面。为此,我使用docutils的rst2html.py工具。
然而,我可能还需要以漂亮的纯文本格式呈现文档,即没有reStructuredText标记,并且仍对文本输出执行段落换行和类似的漂亮格式化。但是,docutils中没有rst2txt.py工具。
是否有一种将reStructuredText转换为漂亮的纯文本格式的方法,也许可以利用docutils的特殊选项?
我计划使用reStructuredText编写文档,主要目的是生成一些漂亮的HTML页面。为此,我使用docutils的rst2html.py工具。
然而,我可能还需要以漂亮的纯文本格式呈现文档,即没有reStructuredText标记,并且仍对文本输出执行段落换行和类似的漂亮格式化。但是,docutils中没有rst2txt.py工具。
是否有一种将reStructuredText转换为漂亮的纯文本格式的方法,也许可以利用docutils的特殊选项?
我还看到过使用rst2html将文本呈现为html,然后使用命令行html浏览器(例如lynx、links、w3m或elinks)将html转换为纯文本的方法:
这些浏览器中的每一个都有一个命令行开关或类似的东西,可以将其输出呈现为.txt文件,因此您可以创建一个名为“rst2txt”的两行脚本,类似于:
rst2html docs.rst docs.html
lynx -dump docs.html > docs.txt
text:
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) _build/text
@echo
@echo "Build finished."
另外,请记住Sphinx只实现了rst规范的一个子集。