網友評分: 4.4分
Zeal 是一款能夠方便使用微軟系統進行代碼的離線文檔瀏覽工具,軟件能夠集成多種語言文檔,方便查閱學習,zeal提供了194個文檔,常見的基本都能找到。
支持呼出熱鍵。只要按下組合箭 ALT+Space 即可在任何地方顯示面板,不用時可以用熱鍵隱藏的系統托盤。
可同時搜索多個文檔
不依賴網絡
GPL 協議開放源碼
Dash 中的文檔都可以在 Zeal 中使用。
一、在首頁上面按下 Docsets 或者 Tools-->Docsets,選擇你想要的文檔進行下載,下載完成后就可以看到你所需要的文檔了。
二、除了在 Zeal 的官網上面下載 Docsets 之外,還能通過 AddFeed 來添加。國外有熱心的開發者收集了一個 Docsets 集合我們只需要點開自己需要的 Docsets,復制 xml 地址到 AddFeed 里面,就可以對應下載 Docsets 了。
三、下載好自己需要的 Docsets 之后,日常就可以在工作中使用離線文檔進行工作了。日常使用過程中,有幾點需要注意:
Zeal 原理是打開 html 的頁面,所以它相當于一個瀏覽器,盡量養成定時關閉不用文檔的習慣
Zeal 能夠設置打開的快捷鍵,設置了之后就能快速打開 Zeal 查閱文檔
Zeal 左上角具備搜索功能,在前面輸入“ 文檔名稱:內容”就可以對指定的文檔進行搜索
四、Zeal 官方寫了一個教我們如何去編寫自己的 Docsets 的文檔,但是該文檔寫得比較簡單,并且沒有詳細地操作指引,操作起來比較復雜。這里借鑒CodeSheep作者的做法!
經過實驗之后,Zeal 的 Docsets 其實是 html 的集合,那么我們可以先用文檔工具,生成一些靜態的 html 文檔。然后通過 Docsets 官方提供的 Docsets 生成器來把 html 生成 Docsets,這樣就可以生成出屬于我們自己的 Docsets 了。
合適的文檔生成器
目前各種開發語言都有文檔生成器,我比較熟悉的 Node.js 生成器就有數十個像 Gitbook、Docsify、Vuepress 等等。但是并不是每一個都適合用來制作 Docsets,舉個例子:
Docsify 是一個很棒的生成器,但是用于 Docsets 的話就會有問題。原因是因為 Docsify 是通過 js 讀取 Markdown 來實現的,而 Zeal 內部是一個瀏覽器,并沒有靜態服務器,所以制作出來的 Docsets 會出現跨域的問題。
最終我選擇了使用 Gitbook 來制作 Docsets,它能生成靜態的 Html 文件,并且能夠通過本地雙擊打開,能夠跟 Zeal 完美融合。