在學習深度學習算法時，發現了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，我還不是很清楚，在此，我真誠的向各位大佬請教😃。

總結

以上是生活随笔為你收集整理的搭建离线版keras中文文档的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。