在许多django项目中,在docs目录中我可以看到* .rst文件:
浏览它们的最佳方式是什么(当然不使用文本编辑器)?
可以生成HTML吗?
答案 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打开该文件。
人们倾向于设置边界和障碍来隐藏他们的知识 - 一段时间。