受网络所限,有时无法在线查看django的官网文档,所以django的离线文档还是比较实用的
前提是: 1.你的py环境已安装sphinx(最好是新版),如果没有此包是无法制作的
2.已经下载了django的安装包(此也和sphinx的版本有关系,最好都是最新版本)
我的实测版本是sphinx1.6.5和django1.11.7
制作生成步骤如下:
1.解压django安装包
2.切换至django解压包里的docs目录
3.使用sphinx生成,可使用里面自带的make(win系统make.bat)脚本
即make html即可自动把docs目录中的文件转换为html文件,默认生成路径为当前路径的_build/html目录中,或者你可以直接使用sphinx-build docs e:\pyhtml 来指定生成路径
如果没有网络则会连接几个地址失败(此为在线检测更新),但是不影响结果