Dash使用小技巧

按照Dash官网的说法：Dash是一个API文档浏览器（ API Documentation Browser），以及代码片段管理工具（Code Snippet Manager）。通常我只会把它当作API文档浏览器，代码片段管理采用SnippetsLab来完成。
Dash是一款很简单的工具，基本上不用什么使用技巧。但是为了更加快速的找到自己需要的内容，还是有些小技巧的。

第一部分：关于Dash的文档集

Dash作为一个API文档浏览器，那么它具体包含哪些文档呢，可以参照下图：

Dash的文档集Docsets

这幅图是我用MindNote绘制的，若是需要进行编辑，去MindNote软件进行更改。

第二部分：关于搜索

1. 选择搜索的语言。

可以通过鼠标进行点选需要搜索的语言，选择好以后，在搜索栏中会出现该语言的图标。

1.1 语言的关键字

通常我们在Dash中都会下载很多文档，不同的API之间需要经常切换。在搜索栏中如果想要切换到想要的文档中，最方便的方式是输入各种API对应的关键字。
关键字的定义在：【Preferences】->【Docsets】中，如下图所示：

Dash的关键字定义

通常，我个人喜欢把python3的关键字由默认的【python3:】改为【p:】，这样非常方便。

1.2 如何用Dash的【Web Search】

虽然，Dash内置的文档已经比较丰富了，但是往往我们需要搜索的东西更多，很多时候我们需要搜索来自Web的内容（比如知乎或者的内容）。
默认情况下，Dash支持在线搜索的内容，是Google，DuckDuckGo，Stack Overflow。但是这三个软件在国内要么不能访问，要么访问速度太慢，所以不能满足我们的需要。我们可以通过下面的方式添加知乎的搜索：

dash-知乎1.png

添加的方法类似：
将name改为：【】
将search URL 改为：【https://www.jianshu.com/search?q={query}&page=1&type=note】

1.3 关于“dash：//”自定义URL方案

这部分属于高级功能，待补充。

2. 选择搜索的内容

当完成第一步以后，在搜索栏中输入需要搜索的内容，敲下回车键，Dash就会把搜索到的结果显示在下面。

2.1在搜索结果中进行上下跳动：

通常搜索出来的结果都很多，需要进行上下移动，方法主要有两种。

1. 通过小键盘区域中的上下箭头来实现向上或者向下移动。
2. 通过快捷键control + P 与control + N 分别进行上下移动。P是Previous，N是Next

3. 在搜索出来的页面中进行搜索。

完成第二步以后就会搜索出对应的页面，如果想要在页面内继续搜索，可以按下command + F 键。
按下command + F键以后，搜索栏就会出现“Find In-Page”，提示我们输入页面内搜索的关键字。
输入完关键字以后，敲下回车键，Dash会跳转到页面内的第一个匹配处。
如果想要继续找下一个匹配项目，可以继续按command + F键，每按一次，向下匹配一个。

3.1 页面搜索的另一种方法

其实如果想要进行页面搜索，还可以在第二步输入关键字以后，敲一个空格键，Dash就会知道你要进行页面搜索了，同时搜索框也会以“Find In-Page”提示你。然后接着输入对应的关键字即可。

第三部分：关于集成

1. Dash如何集成在别的软件中？

Dash是一款非常优秀的软件，其中一个体现就在于可以非常方便的集成在别的优秀软件中。
在【Preferences】->【Integration】中可以看到Dash可以集成在哪些软件中，如下图所示：

Dash集成到别的软件中

如果想要集成到哪个软件，只需要点击对应软件的图标即可实现。

Dash集成到Alfred后的效果

2. Dash集成到Alfred后怎么使用？

为什么要集成，集成的目的肯定是为方便。
在Dash还没集成到Alfred时，想要查看一个文档，需要先打开Dash然后输入关键字进行搜索。
如果集成以后，可以通过快捷键调出Alfred以后，输入关键字直接搜索。这样就跳过了找到Dash、打开Dash这两个步骤，方便不少。

下图：通过快捷方式调出Alfred，输入关键字，我以查询Python3中的time为例。
注意：这里的关键字是以Dash默认的【python3:】为关键字的;
如果把默认的【python3:】修改为【p:】，那么，这边应该输入【p time】

Dash集成后，在Alfred中输入关键字后的效果

下图：输入完关键字，敲击回车键以后自动跳转到Dash中。

从Alfred跳转回到Dash的场景

其他参考文献

1. 少数派写的 [程序员的 API 文档查询利器:Dash]https://zhuanlan.zhihu.com/p/40466851