我正在使用 sphinx-apidoc 为我的 Django 项目自动生成文档,该项目使用 django-social-auth + oauth2 进行身份验证。我希望能够使用相同的身份验证来访问文档。我怎样才能做到这一点?
我查看了django-sphinxdoc,但当前版本与最新的 Haystack 不兼容,并且似乎还有一些其他错误。另外,我真的需要做类似的事情吗 - 将文档转换为 JSON 并将它们存储到数据库中以便在模板上下文中呈现?
我正在使用 sphinx-apidoc 为我的 Django 项目自动生成文档,该项目使用 django-social-auth + oauth2 进行身份验证。我希望能够使用相同的身份验证来访问文档。我怎样才能做到这一点?
我查看了django-sphinxdoc,但当前版本与最新的 Haystack 不兼容,并且似乎还有一些其他错误。另外,我真的需要做类似的事情吗 - 将文档转换为 JSON 并将它们存储到数据库中以便在模板上下文中呈现?
您可以将 sphinx 构建静态 html 文件作为静态文件移动到您的 django web-server 项目中,并简单地添加用户身份验证此静态文件路径。
您可以使用 mod_wsgi 的WSGIAuthUserScript
指令调用 Django 后端进行身份验证。这样你就有了一个以 Django 的用户数据库为后端的 HTTP BASIC AUTH。
请参阅modwsgi 文档和check_password()
编辑:
我刚刚注意到 Django 文档中有一个全面的How To说明。