Zeal食用指南

Zeal食用指南

一、Zeal简介

​ Zeal is anoffline documentation browser for software developers.(Zeal是为软件开发人员准备的离线文档浏览器)。该软件是仿照苹果系统上的Dash (https://kapeli.com/dash)开发而成，并兼容Dash的文档，目前已经有接近200种程序语言的开发文档。事先将文档下载到本地，不仅检索速度快，断网时也可以使用，还能避免百度搜出一大堆广告链接和垃圾结果，效率能提高不少。

官网链接：

https://zealdocs.org/

二、安装配置

1、官网下载

点击 Zeal官网，去下载相应的版本

下载安装完之后，它是默认安装在C盘的，可以直接移动它的根目录到想要的位置。

2、离线文档

我们可以更改离线文档的存储位置

在 Edit -> Preferences 里设置
对于报错的文档,进入到该文档目录下的这个路径：

某某文档.docset\Contents\Resources\Documents\developer.mozilla.org\static\build\js

删除掉 react-main.xxxxxxx.js 这个文件，然后重新打开zeal，就可以使用了

之后，就可以下载想要的文档

在 Tools -> Docsets 里

Zeal 的文档都保存在国外的服务器上，如果用Zeal直接下载，可能会速度极慢，而且容易中断。

所以在网上了解到其他办法

打开下面这个网址，这是 Zeal 在请求文档列表时的json数据。

http://api.zealdocs.org/v1/docsets

ctrl + f 输入 "title":"语言名" 例如：“title”:“JavaScript”

找到后，复制里面的 name 值，因为有些语言的name值和title值不一样

拼接下载链接
zeal离线文档的下载链接格式是：

http://{city_name}.kapeli.com/feeds/{name}.tgz

city_name: 是服务器所在的城市 name: 是刚刚找好的要下载文档的name值

服务器所在的城市如下：

frankfurt, london, newyork, sanfrancisco, singapore, sydney, tokyo

把你要下的文档的name值替换掉下面的链接的{name}即可。

快——> 慢排序（不一定，多试几个看看）

http://tokyo.kapeli.com/feeds/{name}.tgz
http://singapore.kapeli.com/feeds/{name}.tgz
http://sanfrancisco.kapeli.com/feeds/{name}.tgz
http://frankfurt.kapeli.com/feeds/{name}.tgz
http://newyork.kapeli.com/feeds/{name}.tgz
http://sydney.kapeli.com/feeds/{name}.tgz
http://london.kapeli.com/feeds/{name}.tgz

下载完的文档解压放进 Zeal 所设值的离线文档存放位置即可，文档位置可从 Edit—>Preferences---->Directory 找到。

三、常见问题

1、Content rendering error

HTML之类的文档，在双击打开的时候出现以下报错

解决方案

打开文档下载位置，并进入到该目录下

Edit—>Preferences---->Directory

在目录下可以看到有安装的文档的目录

对于报错的文档,进入到该文档目录下的这个路径：

某某文档.docset\Contents\Resources\Documents\developer.mozilla.org\static\build\js

删除掉 react-main.xxxxxxx.js 这个文件，然后重新打开zeal，就可以使用了