我在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.txt
,docs/intro/install.txt
错误等问题{1}}个文件。我能够在Google上找到很少的描述我遇到的确切问题所以我尝试使用其他选项。
天真地认为错误是docutils的原生,我决定搜索另一个工具并找到this page并安装了restview。好吧,我没有意识到restview使用了docutils所以我最终回到了第一个方向。
如何摆脱这些和其他错误?我是否正确安装了docutils和restview?
请告诉我是否需要添加更多信息
答案 0 :(得分:2)
您需要使用Sphinx。这个工具is used by the Django project,它定义了额外的reStructuredText结构,以补充由docutils定义的结构。如