在学习深度学习算法时，发现了keras这个成熟的api，于是开启了keras的学习之路。在学习过程中，发现csdn中有大佬搭建了离线版的keras文档，遂亲自尝试。现将搭建过程中遇到的问题和解决办法整理如下：
keras官网传送门：https://keras.io/zh/
主要参考文档：Keras中文官方文档(离线版)：/u010299280/article/details/82705336
文章截图较多，便于大家理解文字，搭建过程总体来说不难！
目录导航
一、从github下载文档二、解压缩三、修改mokdoc.yml文件四、安装mokdoc五、用build生成静态文件六、启动文档一、从github下载文档
github官网传送门：/keras-team/keras-docs-zh
如果本机的git配置成功，也可以使用命令从github下载：
git clone /keras-team/keras-docs-zh
二、解压缩
把下载好的压缩包 （名为keras-docs-zh-master.zip）解压到一个文件夹中
三、修改mokdoc.yml文件
打开mokdoc.yml文件，最原始的文件如下图所示：
删除红框框选的内容，然后替换为readthedocs，如下图所示：
注意点1：
dev_addr可以保留原来的写法。有网友说原有写法会导致keras加载过慢，可以尝试把0.0.0.0改为localhost
四、安装mokdoc
pip install mkdocs
五、用build生成静态文件
进入我们解压缩的目录，然后输入cmd
输入下面的命令：
mkdocs build
如果不报错的话，应该是显示下面的结果：
六、启动文档
输入下面的命令：
mkdocs server
如果不报错的话，应该是显示下面的结果：
在浏览器输入：localhost:8000，回车，即可看到运行起来的文档
注意点2：
《Keras中文官方文档(离线版)》的作者提到，在对直接解压未修改yml的文件build时，可能会遇到如下的错误：
WARNING - Config value: 'dev_addr'. Warning: The use of the IP address '0.0.0.0' suggests a production environment or the use of a proxy to connect to the MkDocs server. However, the MkDocs' server is intended for local development purposes only. Please use a third party production-ready server instead.ERROR - Config value: 'theme'. Error: The path set in theme.custom_dir ('D:\software\keras文档\theme') does not exist.Aborted with 1 Configuration Errors!
作者提到，可以修改custom_dir的值为sources
但，我在测试时还是会报错，报错如下：
使用第三步的方法就可以避免这些报错。产生这些报错的原因，由于初次接触mokdoc，我还不是很清楚，在此，我真诚的向各位大佬请教😃。
如果觉得《搭建离线版keras中文文档》对你有帮助，请点赞、收藏，并留下你的观点哦！
