用 restview 阅读 Django 文档答案

【问题标题】：Reading Django documentation with restview用 restview 阅读 Django 文档
【发布时间】：2013-09-05 03:33:58
【问题描述】：

我在我的 Windows XP 桌面上的 Virtual Box 上使用 Fedora 18 来学习 Django。在浏览了.txt 文档文件后，我发现这些文件是使用 restructuredText 编写的。我花了最后一天左右的时间试图弄清楚如何将文件转换为可读的东西（HTML、Latex、PDF 等）。我做的第一件事是安装 docutils（来自 source - 下载页面）并使用 rst2html.py 将文件转换为可读的 HTML。

当我使用此工具时，我在打开 docs/intro/index.txt、docs/intro/install.txt 和 docs/intro/tutorial01.txt 文件时收到了 Unknown interpreted text role "doc"、Unknown interpreted text role "ref"、Unknown interpreted text role "term" 错误等。我在 Google 上几乎找不到描述我遇到的确切问题的内容，因此我尝试使用不同的选项。

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

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

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

【问题讨论】：

标签： django python-2.7 restructuredtext docutils

【解决方案1】：

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

【讨论】：

我将不得不对其进行更多研究。我已经安装了它，但认为它仅用于生成文档。我想我可以用它来阅读 ReST 是有道理的
我查看了您发布到 Django 项目的链接，它准确地告诉了我该怎么做。不幸的是，我收到了另一个错误，但我正在朝着正确的方向前进。谢谢