Django doc app无法正常工作

Question

我有一个Django 1.5项目，我在其中创建了一个API应用程序，并且已经记录了sphinx 1.2b2。当站点放在服务器中时，我想使用文档作为网页进行访问。

我做了一点研究，发现有一个名为django-docs的应用程序，我已经安装了qith这个配置：

settings.py：

SITE_ROOT = os.path.dirname(os.path.realpath(__file__))
DOCS_ROOT = os.path.join(SITE_ROOT, '../docs/_build/html/')

urls.py：

urlpatterns = patterns('',
    url(r'^api/', include('app.api.urls')),
    url(r'^admin/', include(admin.site.urls)),
    url(r'^docs/', include('docs.urls')),
)

每当我访问“/ docs /”时，我都能看到我的sphinx文档的index.html，但它没有CSS样式 当我点击“API”链接时，网址如下所示：“/ docs / _file / api.html”但页面继续显示index.html。当我再次点击“API”链接时，网址看起来像“/docs/_file/_file/api.html”，页面显示错误：

  

“/../ docs / _build / html / _files / _files / api.html”不存在

如何解决链接引用？如何添加静态CSS文件？

Answer 1

我将sphinx版本更改为1.1.3并且它正常工作。