制作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