搭建离线版keras中文文档

在学习深度学习算法时，发现了keras这个成熟的api，于是开启了keras的学习之路。在学习过程中，发现csdn中有大佬搭建了离线版的keras文档，遂亲自尝试。现将搭建过程中遇到的问题和解决办法整理如下：
keras官网传送门：https://keras.io/zh/

主要参考文档：Keras中文官方文档(离线版)：https://blog.csdn.net/u010299280/article/details/82705336

文章截图较多，便于大家理解文字，搭建过程总体来说不难！

目录导航

一、从github下载文档
二、解压缩
三、修改mokdoc.yml文件
四、安装mokdoc
五、用build生成静态文件
六、启动文档

一、从github下载文档

github官网传送门：https://github.com/keras-team/keras-docs-zh

如果本机的git配置成功，也可以使用命令从github下载：

git clone https://github.com/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 Mk
Docs 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，我还不是很清楚，在此，我真诚的向各位大佬请教