用restview读取Django文档

Question

我正在使用Fedora 18虚拟盒在我的Windows桌面上学习Django。在浏览了.txt文档文件之后，我发现这些文件是使用restructuredText编写的。最后一天，我一直在试图找出如何将文件转换成可读的东西(HTML、Latex、PDF等)。我做的第一件事是安装docutils (从来源 -下载页面)，并使用rst2html.py将文件转换为HTML以便于阅读。

当我使用这个工具时，当我打开Unknown interpreted text role "doc"、Unknown interpreted text role "ref"和docs/intro/tutorial01.txt文件时，我会得到更多的docs/intro/index.txt、Unknown interpreted text role "ref"、Unknown interpreted text role "term"错误。我在谷歌上发现的很少，只是描述了我遇到的确切问题，所以我尝试使用另一种选择。

天真地认为这些错误是docutils固有的，于是我决定搜索另一个工具，找到了此页并安装了restview。嗯，我没有意识到restview使用了docutils，所以我回到了起点。

如何消除这些错误和其他错误？我是否正确地安装了docutils和restview？

如果我需要添加更多的信息，请告诉我

Answer 1

您需要使用狮身人面像。这个工具被Django项目使用。及其定义了额外的reStructuredText结构，以补充由docutils定义的结构。比如

• http://sphinx-doc.org/markup/inline.html#role-doc
• http://sphinx-doc.org/markup/inline.html#role-ref
• http://sphinx-doc.org/markup/inline.html#role-term