用restview阅读Django文档

时间:2013-09-02 05:29:12

标签: django python-2.7 restructuredtext docutils

我在Windows XP桌面上的Virtual Box上使用Fedora 18来学习Django。在浏览了.txt文档文件后,我发现这些文件是使用restructuredText编写的。我花了最后一天左右试图找出如何将文件转换成可读的内容(HTML,Latex,PDF等)。我做的第一件事是安装docutils(来自source - 下载页面)并使用rst2html.py将文件转换为HTML以便可读。

当我使用此工具时,我在打开Unknown interpreted text role "doc"Unknown interpreted text role "ref"和{时遇到Unknown interpreted text role "term"docs/intro/index.txtdocs/intro/install.txt错误等问题{1}}个文件。我能够在Google上找到很少的描述我遇到的确切问题所以我尝试使用其他选项。

天真地认为错误是docutils的原生,我决定搜索另一个工具并找到this page并安装了restview。好吧,我没有意识到restview使用了docutils所以我最终回到了第一个方向。

如何摆脱这些和其他错误?我是否正确安装了docutils和restview?

请告诉我是否需要添加更多信息

1 个答案:

答案 0 :(得分:2)

您需要使用Sphinx。这个工具is used by the Django project,它定义了额外的reStructuredText结构,以补充由docutils定义的结构。如