按照Dash官網(wǎng)的說(shuō)法:Dash是一個(gè)API文檔瀏覽器( API Documentation Browser),以及代碼片段管理工具(Code Snippet Manager)蔗喂。通常我只會(huì)把它當(dāng)作API文檔瀏覽器挽铁,代碼片段管理采用SnippetsLab來(lái)完成筒狠。
Dash是一款很簡(jiǎn)單的工具离唐,基本上不用什么使用技巧。但是為了更加快速的找到自己需要的內(nèi)容冤今,還是有些小技巧的摩桶。
第一部分:關(guān)于Dash的文檔集
Dash作為一個(gè)API文檔瀏覽器桥状,那么它具體包含哪些文檔呢,可以參照下圖:
這幅圖是我用MindNote繪制的典格,若是需要進(jìn)行編輯岛宦,去MindNote軟件進(jìn)行更改。
第二部分:關(guān)于搜索
1. 選擇搜索的語(yǔ)言耍缴。
可以通過鼠標(biāo)進(jìn)行點(diǎn)選需要搜索的語(yǔ)言砾肺,選擇好以后,在搜索欄中會(huì)出現(xiàn)該語(yǔ)言的圖標(biāo)防嗡。
1.1 語(yǔ)言的關(guān)鍵字
通常我們?cè)贒ash中都會(huì)下載很多文檔变汪,不同的API之間需要經(jīng)常切換。在搜索欄中如果想要切換到想要的文檔中蚁趁,最方便的方式是輸入各種API對(duì)應(yīng)的關(guān)鍵字裙盾。
關(guān)鍵字的定義在:【Preferences】->【Docsets】中,如下圖所示:
通常,我個(gè)人喜歡把python3的關(guān)鍵字由默認(rèn)的【python3:】改為【p:】番官,這樣非常方便庐完。
1.2 如何用Dash的【W(wǎng)eb Search】
雖然,Dash內(nèi)置的文檔已經(jīng)比較豐富了徘熔,但是往往我們需要搜索的東西更多门躯,很多時(shí)候我們需要搜索來(lái)自Web的內(nèi)容(比如知乎或者簡(jiǎn)書的內(nèi)容)。
默認(rèn)情況下酷师,Dash支持在線搜索的內(nèi)容讶凉,是Google,DuckDuckGo山孔,Stack Overflow懂讯。但是這三個(gè)軟件在國(guó)內(nèi)要么不能訪問,要么訪問速度太慢台颠,所以不能滿足我們的需要褐望。我們可以通過下面的方式添加知乎的搜索:
添加簡(jiǎn)書的方法類似:
將name改為:【簡(jiǎn)書】
將search URL 改為:【http://www.reibang.com/search?q={query}&page=1&type=note】
1.3 關(guān)于“dash://”自定義URL方案
這部分屬于高級(jí)功能,待補(bǔ)充蓉媳。
2. 選擇搜索的內(nèi)容
當(dāng)完成第一步以后譬挚,在搜索欄中輸入需要搜索的內(nèi)容,敲下回車鍵酪呻,Dash就會(huì)把搜索到的結(jié)果顯示在下面。
2.1在搜索結(jié)果中進(jìn)行上下跳動(dòng):
通常搜索出來(lái)的結(jié)果都很多盐须,需要進(jìn)行上下移動(dòng)玩荠,方法主要有兩種。
- 通過小鍵盤區(qū)域中的上下箭頭來(lái)實(shí)現(xiàn)向上或者向下移動(dòng)贼邓。
- 通過快捷鍵control + P 與control + N 分別進(jìn)行上下移動(dòng)阶冈。P是Previous,N是Next
3. 在搜索出來(lái)的頁(yè)面中進(jìn)行搜索塑径。
完成第二步以后就會(huì)搜索出對(duì)應(yīng)的頁(yè)面女坑,如果想要在頁(yè)面內(nèi)繼續(xù)搜索,可以按下command + F 鍵统舀。
按下command + F鍵以后匆骗,搜索欄就會(huì)出現(xiàn)“Find In-Page”,提示我們輸入頁(yè)面內(nèi)搜索的關(guān)鍵字誉简。
輸入完關(guān)鍵字以后碉就,敲下回車鍵,Dash會(huì)跳轉(zhuǎn)到頁(yè)面內(nèi)的第一個(gè)匹配處闷串。
如果想要繼續(xù)找下一個(gè)匹配項(xiàng)目瓮钥,可以繼續(xù)按command + F鍵,每按一次,向下匹配一個(gè)碉熄。
3.1 頁(yè)面搜索的另一種方法
其實(shí)如果想要進(jìn)行頁(yè)面搜索桨武,還可以在第二步輸入關(guān)鍵字以后,敲一個(gè)空格鍵锈津,Dash就會(huì)知道你要進(jìn)行頁(yè)面搜索了玻募,同時(shí)搜索框也會(huì)以“Find In-Page”提示你。然后接著輸入對(duì)應(yīng)的關(guān)鍵字即可一姿。
第三部分:關(guān)于集成
1. Dash如何集成在別的軟件中七咧?
Dash是一款非常優(yōu)秀的軟件,其中一個(gè)體現(xiàn)就在于可以非常方便的集成在別的優(yōu)秀軟件中叮叹。
在【Preferences】->【Integration】中可以看到Dash可以集成在哪些軟件中艾栋,如下圖所示:
如果想要集成到哪個(gè)軟件,只需要點(diǎn)擊對(duì)應(yīng)軟件的圖標(biāo)即可實(shí)現(xiàn)蛉顽。
2. Dash集成到Alfred后怎么使用蝗砾?
為什么要集成,集成的目的肯定是為方便携冤。
在Dash還沒集成到Alfred時(shí)悼粮,想要查看一個(gè)文檔,需要先打開Dash然后輸入關(guān)鍵字進(jìn)行搜索曾棕。
如果集成以后扣猫,可以通過快捷鍵調(diào)出Alfred以后,輸入關(guān)鍵字直接搜索翘地。這樣就跳過了找到Dash申尤、打開Dash這兩個(gè)步驟,方便不少衙耕。
下圖:通過快捷方式調(diào)出Alfred昧穿,輸入關(guān)鍵字,我以查詢Python3中的time為例橙喘。
注意:這里的關(guān)鍵字是以Dash默認(rèn)的【python3:】為關(guān)鍵字的;
如果把默認(rèn)的【python3:】修改為【p:】时鸵,那么,這邊應(yīng)該輸入【p time】
下圖:輸入完關(guān)鍵字饰潜,敲擊回車鍵以后自動(dòng)跳轉(zhuǎn)到Dash中。
其他參考文獻(xiàn)
- 少數(shù)派寫的 [程序員的 API 文檔查詢利器:Dash]https://zhuanlan.zhihu.com/p/40466851