我目前正在使用Sphinx为一个相当复杂的Django网站编写一些大量文档。我一直在内部工作,在我很快离开之前,我想留下新的开发人员/管理员可以访问的详细文档。
我的问题是我可以选择托管此文档吗?我希望它是私人的。文档也涉及网站而不是python包。出于这两个原因,我认为阅读文档可能不是最合适的选择。
我跑过django-sphinxdoc,虽然这需要设置Haystack作为后端。有没有办法简单地使用内置的js搜索服务器文档?或者允许私人托管文档的服务?
非常感谢任何选项。
答案 0 :(得分:15)
Sphinx可以生成静态.html
文件(make html
)。将这些HTML文件放在内部Web服务器上,你应该很高兴。
答案 1 :(得分:0)
请参阅此question的答案(完全披露,我问了问题,没有回答做了一些研究和编码并发布了答案,所以虽然它有效但可能会有更好的那些。我会如果有人指出它们,我们会非常感激。)
这个gitlab repo显示了一个工作示例here。
使用static password protection并在此issue中讨论。