离线文档查阅软件Zeal

原文链接http://kanng.cn

Zeal是一款离线文档查看软件，类似于MacOs上的Dash（事实Zeal就是山寨的Dash，它可直接使用Dash的文档格式），但是Dash只支持Mac系统，而Zeal是跨平台的， Linux, Windows, Mac都可以运行。

下载安装地址：Zeal官方网站

一些开源软件虽然有很好的在线文档，但是只能在线看，没有提供PDF或者HTML格式的文档下载（比如Elasticsearch的文档），在没有网络或者网络很差时就看不了。这时 通过Zeal下载已经打包好的离线文档很就方便了。

Zeal使用起来有点问题，网络不好时下载文档很慢，偶尔会下载到一半中途断线后又从头下载，这种情况下可以自己先手动下载文档，然后导入到Zeal，离线文档的下载地址可以从GitHub上的 一个开源项目得到: https://github.com/kitty-panics/zeal-docs-downloader

git clone https://ghproxy.com/https://github.com/kitty-panics/zeal-docs-downloader.git

要得到文档的地址，也可以参考这个项目：https://github.com/Kapeli/feeds

以下载Elasticsearch的文档来演示说明：

下面的命令均以Linux系统来演示，如果是Windows系统，根据实际情况做一下调整。

1. 先找到地址

用ag命令搜索:

# 当前目录zeal-docs-downloader
ag 'elasticsearch'

ag命令没有就用grep，或者安装一下apt install silversearcher-ag

输出大致如下：

official-london.txt
53:http://london.kapeli.com/feeds/ElasticSearch.tgz

official-sanfrancisco.txt
53:http://sanfrancisco.kapeli.com/feeds/ElasticSearch.tgz

official-newyork.txt
53:http://newyork.kapeli.com/feeds/ElasticSearch.tgz

official-tokyo.txt
53:http://tokyo.kapeli.com/feeds/ElasticSearch.tgz

official-frankfurt.txt
53:http://frankfurt.kapeli.com/feeds/ElasticSearch.tgz

2. 下载

从一个地理位置比较近（或者随便一个）的服务器下载文档：

wget http://tokyo.kapeli.com/feeds/ElasticSearch.tgz

3. 导入到Zeal

Zeal的文档在Linux中存放目录是~/.local/share/Zeal/Zeal/docsets

tar -zxvf ElasticSearch.tgz -C ~/.local/share/Zeal/Zeal/docsets

导入后要重启Zeal才会看到新加入的文档

下载文档的旧版

默认zeal只会下载某个文档的最新版，如果要下载某个历史版本：

以及Redis为例，最新版的下载地址是：https://kapeli.com/feeds/Redis.tgz，把tgz换为xml可以请求得到一个xml文件，从而得知由那些版本：

wget https://kapeli.com/feeds/Redis.xml'

<entry>
    <version>7.0.9</version>
    <ios_version>1</ios_version>
    <url>http://sanfrancisco.kapeli.com/feeds/Redis.tgz</url>
    <url>http://london.kapeli.com/feeds/Redis.tgz</url>
    <url>http://newyork.kapeli.com/feeds/Redis.tgz</url>
    <url>http://tokyo.kapeli.com/feeds/Redis.tgz</url>
    <url>http://frankfurt.kapeli.com/feeds/Redis.tgz</url>
    <other-versions>
        <version><name>7.0.9</name></version>
        <version><name>6.2.6</name></version>
        <version><name>6.0.10</name></version>
        <version><name>5.0.9</name></version>
        <version><name>4.0.11</name></version>
        <version><name>3.2.9</name></version>
        <version><name>3.0.7</name></version>
        <version><name>2.8.19</name></version>
        <version><name>2.6.16</name></version>
    </other-versions>
</entry>

假设要下载6.2.6版本的文档，下载地址为：http://kapeli.com/feeds/zzz/versions/Redis/6.2.6/Redis.tgz

要下载其他软件历史版本，把url中的软件名字和版本号替换即可得到url