在學(xué)習(xí)深度學(xué)習(xí)算法時(shí)，發(fā)現(xiàn)了keras這個(gè)成熟的api，于是開啟了keras的學(xué)習(xí)之路。在學(xué)習(xí)過程中，發(fā)現(xiàn)csdn中有大佬搭建了離線版的keras文檔，遂親自嘗試。現(xiàn)將搭建過程中遇到的問題和解決辦法整理如下：
keras官網(wǎng)傳送門：https://keras.io/zh/

主要參考文檔：Keras中文官方文檔(離線版)：https://blog.csdn.net/u010299280/article/details/82705336

文章截圖較多，便于大家理解文字，搭建過程總體來說不難！

目錄導(dǎo)航

• • • 一、從github下載文檔
    • 二、解壓縮
    • 三、修改mokdoc.yml文件
    • 四、安裝mokdoc
    • 五、用build生成靜態(tài)文件
    • 六、啟動(dòng)文檔

一、從github下載文檔

github官網(wǎng)傳送門：https://github.com/keras-team/keras-docs-zh

如果本機(jī)的git配置成功，也可以使用命令從github下載：

git clone https://github.com/keras-team/keras-docs-zh

二、解壓縮

把下載好的壓縮包 （名為keras-docs-zh-master.zip）解壓到一個(gè)文件夾中

三、修改mokdoc.yml文件

打開mokdoc.yml文件，最原始的文件如下圖所示：

刪除紅框框選的內(nèi)容，然后替換為readthedocs，如下圖所示：

注意點(diǎn)1：

dev_addr可以保留原來的寫法。有網(wǎng)友說原有寫法會(huì)導(dǎo)致keras加載過慢，可以嘗試把0.0.0.0改為localhost

四、安裝mokdoc

pip install mkdocs

五、用build生成靜態(tài)文件

進(jìn)入我們解壓縮的目錄，然后輸入cmd

輸入下面的命令：

mkdocs build

如果不報(bào)錯(cuò)的話，應(yīng)該是顯示下面的結(jié)果：

六、啟動(dòng)文檔

輸入下面的命令：

mkdocs server

如果不報(bào)錯(cuò)的話，應(yīng)該是顯示下面的結(jié)果：

在瀏覽器輸入：localhost:8000，回車，即可看到運(yùn)行起來的文檔

注意點(diǎn)2：

《Keras中文官方文檔(離線版)》的作者提到，在對(duì)直接解壓未修改yml的文件build時(shí)，可能會(huì)遇到如下的錯(cuò)誤：

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

但，我在測試時(shí)還是會(huì)報(bào)錯(cuò)，報(bào)錯(cuò)如下：

使用第三步的方法就可以避免這些報(bào)錯(cuò)。產(chǎn)生這些報(bào)錯(cuò)的原因，由于初次接觸mokdoc，我還不是很清楚，在此，我真誠的向各位大佬請(qǐng)教😃。

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。