1.如何下载Github海量的文档

image.png

在github上还是有很多优秀的文献资料，目前国内gitee也逐渐崛起，希望以后dash可以直接支持gitee文档导入

2.文档分组使用

• 在不同应用场景需求中，分组检索可以提高效率和减少干扰使用

  
  image.png

dash 6 下载github慢怎么解决

这个问题也是耽搁了我一天时间，首先访问github本身比较缓慢，加上dash clone文档的同时转义docset(dash支持文档主要格式)，结合Twitter开发者反馈信息来看，即时海洋彼岸下载github也需要大概5分钟，在使用过程最少也是30分钟或者一个小时。如果急需使用的话，确实是头疼的问题。

dash 6 文档翻译

• 大多开发文档几乎都是英文，dash只是解决快速检索和查看的问题。也和开发者有过沟通，目前对于文档翻译的功能是遥遥无期洛
• 在多次辗转使用的过程中，无意按到了快捷键当前页面在Google浏览器打开
  嘿哈！ 关于翻译的这个事情有了转机，当前页面在浏览器中打开，右键翻译就是家常便饭了
• 当然最好还是提升英语，阅读无障碍。

image.png

截止北京时间：2021-11-30 写完发现右键也能翻译文档，不知道是不是macOS Monterey系统自带还是应用已经升级了 -_-

image.png

在线网站转离线文档

• 离线网页工具：sitesucker
• 网页转文档格式docset：html2Dash

html2Dash 使用教程

• Mac OS 最新系统对Python2的兼容问题等，环境搭建在Docker中使用方便
• 安装并使用

 #python环境搭建
docker run -it -d  --name python2  -v /Users/irounds/Develop/docs:/usr/src/myapp -w /usr/src/myapp python:2
#安装 beautifulsoup4==4.3.2
pip install bs4
#生成文档并指定图标 输出文档于当前文档 -d 可指定输出指定路径
./html2dash.py -n javalin -i ~/javalin_icon.png ../javalin 

使用快捷键

CMD+B 浏览器打开（可在线翻译文档）