如何浏览(没有文本编辑器).rst文件?

时间:2010-04-05 22:05:15

标签: django documentation

在许多django项目中,在docs目录中我可以看到* .rst文件:

浏览它们的最佳方式是什么(当然不使用文本编辑器)?

可以生成HTML吗?

4 个答案:

答案 0 :(得分:26)

.rst个文件格式为ReStructuredText。它们看起来像文本文件,但可以使用Python docutils包呈现为HTML。

答案 1 :(得分:14)

正如zjk所说,你可以使用restview:

  

可以从Python包索引中获取restview:http://pypi.python.org/pypi/restview。你也可以pip install restview。

以下是我使用虚拟环境测试它的方法:

mkdir restview
cd restview/
virtualenv-2.7 venv   # The second system I used just used 'virtualenv venv'
./venv/bin/pip install restview
./venv/bin/restview ~/path/MANUAL.rst 

这启动了一个Web服务器并在我的浏览器中打开了文档页面。

注意:我只使用了virtualenv,因为我不喜欢全局安装。对于其他许多人来说,这可能有点过分,但我对这些一次性的环境有更好的运气。当我在Ubuntu 14.04 VM上尝试pip install restview时,它失败了,而上面的方法在我的系统和这个系统上都像是一个魅力。

答案 2 :(得分:9)

尝试restview

答案 3 :(得分:-4)

只需将文件扩展名重命名为.txt,然后使用任何texteditor打开该文件。

人们倾向于设置边界和障碍来隐藏他们的知识 - 一段时间。