rST文件语法产生的格式效果如何查看？ 第1页

其实我认为GitHub就支持rST文件的预览，你可以尝试把文件传上去看看效果。这是我在研究Python的源码时发现的：python/cpython，这个应该是从源码自动提取生成的rST文件。

另外一种方法 这里是一个基于Flask实现的rST在线编辑器，可以实现实时预览渲染的结果：rsted。里面提到的在线网站 http://rst.ninjs.org/ 已经关停，但是可以下载下来在本地跑：

       git@github.com:anru/rsted.git pip install -r pip-requirements.txt     

由于项目年久失修，这个项目应该是使用Python2.7编写的，如果你要使用Python3.x，需要修改一些地方：

1. 注释掉application.py中的reload，这个是用来控制utf-8编码的，Python3.x默认就是这个编码

       #!/usr/bin/env python # all the imports  import os, sys # reload(sys) # sys.setdefaultencoding('utf-8') ...     

2. 修改rsted/pdf.py中对StringIO的导入，在Python3.x中它被包含在io中了

       from rst2pdf.createpdf import RstToPdf import codecs utf8codec = codecs.lookup('utf-8')  from flask import current_app  try:     from cStringIO import StringIO except ImportError:     from io import StringIO # 修改这里 ...     

3. 修改setting.py中的字典关键字判断语句，has_key已经被淘汰了

       import os  # configuration DEBUG = not 'RSTED_PROD' in os.environ     

然后运行python ./application.py就可以通过localhost:5000访问了。如果你有服务器，也可以把这个挂在服务器上造福人类！运行效果如下：

另外，我不知道rST的语法有没有更新过，最上面我提到的Python源码中c-api的rST文档在这里渲染全是报错。