離線文檔查閱軟件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