Zeal——好用的离线 API 文档大全!


介绍

作为一名程序员,工作中学习中免不了是要查询API文档的,毕竟我们能记住的东西有限,而且经常也会碰到某个API一时想不起来的情况,而每次还要打开网页去查询还是挺麻烦的,这时候拥有一个款好用的本地离线API文档大全就派上用场了,得益于Dash(mac),Zeal的文档非常丰富,截止2018.8.23已经有192个API文档了,官方地址:Zeal,拉到最下面可以看到支持的文档列表。

(PS:Zeal下载的文档是英文文档,还可以锻炼英文文档的阅读能力哦,貌似也是可以下载中文文档的离线文档包,但是我没有去探索)

下载文档

如何安装就不说了,打开安装包点下一步就行了,如何使用呢?Zeal安装完成后并不是直接可以用的,而是需要我们手动的去选择想要下载的API文档,当然选择下载文档之前你最好先选择一下文档的存放位置,Zeal的默认安装位置是C盘,文档存放地址也是,所以你需要在C盘之外的盘新建一个文件夹(你要放C盘的话也可以),然后在Zeal左上角选项Edit > prefrrences 点击打开如图面板,点击箭头处改为你想要存放的文件夹路径

接下来要下载文档了,点击左上角选项Tools > docsets 打开如下面板:

左边的选项卡是installed,是你已经下载的文档,右边的选项卡则是可以下载还未下载的文档,双击下载吧。稍微等候一会就会下载完成并出现在Zeal的主页面中左侧列表。

使用

使用也很方便,可以直接搜索你要的API,例如搜索slice,会将你已经下载的所有文档当中拥有这个API的都列出来,通过前面图标区分。

也可以使用JavaScript:slice这样限制只搜索JavaScript当中的slice API

一个坑

在折腾Zeal的时候遇到了一个问题,那就是明明在面板中点击下载了,但是已经下载的列表并没有显示该文档,在主页面也不能看到该文档,刷新列表之后又显示在未下载列表中。

当时我下载的是JavaScript包,这个包出问题让我很悲伤,后来又尝试了下载其他包都没有问题,打开文档存放的文件夹也的确已经下载好了,但是仍然不能显示。上网查找后也没有发现类似问题,也可能是因为我关键字不对。

经过一番查看后,发现Javascript包对比其他的包,在包的文档文件夹(每个文档都独立的放在一个xxx.docset的文件夹)contents文件夹下缺少了一个Info.plist文件,于是尝试着从CSS包当中复制了一个该文件副本到JavaScript.docsets/contents当中,打开后如下图,显然这个文件是有点类似配置文件的东东:

然后将图上箭头处的CSS都更改为JavaScript,并且将红色划线处更改为index.html(这里应该是文档在zeal当中显示首页的地址,是相对于JavaScript.docset\Contents\Resources\Documents的相对路径,而JavaScriot的index.html是直接在该路径下的,所以只写了index.html就行了)之后保存,打开Zeal,发现JavaScript出现了,并且可以正常使用!愉悦啊!可以开心的阅读文档了(: