使用 Sphinx CSS 的开发服务器上的 Django 文档不起作用

Question

我正在尝试在我的 Django 开发服务器上结合 Sphinx。我知道我可以更好地使用 apache。但是我不能使用 apache，因为项目将由其他人管理，并且项目需要尽可能简单地工作。没有太多的外部库等。

所以我在我的 url 中尝试了 django-docs 包和 django.static.serve。 HTML 页面可以工作，只有页面的外观是纯 html，因此不包含 CSS。 django-docs 上的文档非常糟糕，我似乎无法让它与 Sphinx 创建的静态文件一起使用。我也不能使用 sphinxdocs，因为它需要添加到我的外部库中的干草堆。

我将 django-docs 添加到我安装的应用程序中，并将其添加到我的设置中。 projectpath 是我的 conf.py 所在的路径。我不确定位置是否正确。但是文档并不清楚我应该在项目路径部分填写什么。我在我的 urlspatterns 中添加了网址

DOCS_ROOT = os.path.join(PROJECT_PATH, '../docs/_build/html')
DOCS_ACCESS = 'staff'

url(r'^docs/', include('docs.urls')),

在 sphinx doc 中，静态文件位于 docs/_build/html/_static

Answer 1

我发现了问题如果其他人有问题。我的 docs 文件夹中有一些其他名为 static 的文件夹。当我删除它们时，它起作用了。所以只是我有点笨。