製作TensorFlow2.1文檔
參考:https://github.com/ppwwyyxx/dash-docset-tensorflow
推薦免費的離線文檔工具:zeal
離線文檔示例
MacOS使用:Dash for Mac
Windows使用:velocity
背景
爲Dash for Mac
製作TensorFlow
的本地文檔
參考dash-docset-tensorflow
代碼庫時,www.tensorflow.org
無法訪問,且tensorflow官網有cn版本,所以需要改一下代碼
修改
-
修改
dashing.json
修改externalURL
爲https://tensorflow.google.cn/
-
修改
preprocess.sh
修改第28行,改爲
find tensorflow.google.cn/
運行
- 安裝
dashing
參考dasing代碼庫
brew install dashing
- 安裝必要庫
pip install python-magic beautifulsoup4 lxml
如果出現以下錯誤
Error:failed to find libmagic. Check your installation 3ikn
參考博客:需要安裝python-magic-bin
:
pip install python-magic-bin
- 下載
tensorflow
線上文檔
原有命令如下,但www.tensorflow.org
出現404
wget -nc -np --compression=gzip --domains=www.tensorflow.org -e robots=off --adjust-extension -r 'https://www.tensorflow.org/api_docs/'
將網址變更爲tensorflow.google.cn
wget -nc -np -b --compression=gzip --domains=tensorflow.google.cn -e robots=off --adjust-extension -r 'https://tensorflow.google.cn/api_docs/'
- 複製
dashing.json
、main.css
和icon
到tensorflow.google.cn
目錄下
# 原有命名爲:
# cp dashing.json icon*.png main.css www.tensorflow.org
cp dashing.json icon*.png main.css tensorflow.google.cn
- 運行
preprocess.sh
腳本
# 原有命令爲:
# ./preprocess.sh www.tensorflow.org
./preprocess.sh tensorflow.google.cn
- 編譯
dash
cd tensorflow.google.cn
dashing build