好用的程序猿文档管理软件:dash 和 zeal
发布于 作者:苏南大叔 来源:程序如此灵动~大多数程序猿都会在不同的编程语言之间来回穿梭,那么难免会对有些函数拿不准,需要进行查询确认。那么,这个时候,你就需要一个好的文档管理软件。在本篇文章中,苏南大叔就给大家介绍两款软件,dash
和zeal
。不过,首先要澄清一个概念,就是dash
和zeal
的关系,是剪不断理还乱。苏南大叔估计:实际上是同一款软件,在不同平台下面的两个名字。
本文试验环境:mac
,dash@4.6.0
。
dash
和zeal
虽然没有官方的说法,dash
和zeal
归属同一家。但是,两者的相似性及文档的通用性,难以让人不相信他们没有关系。在mac
平台下,它叫做dash
。在win
平台下面,它叫做zeal
。并且需要说明的是:zeal
是开源的,dash
是收费不开源的。
下面是相关的网站:
dash
官网: https://kapeli.com/dash
zeal
官网: https://zealdocs.org/
dash
并不开源,而且是款收费软件。不过,官方的收费说明上写着:不交钱也是可以正常使用的。只不过会偶尔不时的收到收费的提示罢了。所以,大家可能也并不需要着啥急,这个罗马尼亚程序员,也不是那么黑心的说。
由于苏南大叔试用的平台是mac
,而且dash
和zeal
的高度相似性。在本文的主体内容里面,苏南大叔就仅仅描述dash
了。
dash
下载文档
dash
里面自建了好多个渠道,可以用于下载文档。不同的渠道有不同的文档,其中前三个渠道是可以直接下载的,后面的几个渠道,还需要先安装一些插件才能使用。
文档搜索的时候,左侧的一系列来源中,都可能有结果,具体的就是需要看,渠道上的数字代表着相关搜索结果。需要点击开具体的某个来源,才能得到这个来源相关的结果。这点上来说,用户体验不是太好。
dash
添加自定义文档
大多数时候,大家需要的文档,都可以在dash
里面找到。但是,毕竟现在的各种新的编程语言,层出不穷。所以,没有你想要的文档的概率,还是存在的。
那么,dash
也支持自定义文档。大家可以自己做个需要的文档,放进去。官方提供的制作方法,说实话看起来还是蛮复杂痛苦的。不过,github
上面有几个开源的代码。可以让做文档这件事情,变得简单一些。苏南大叔觉得,这个文档的制作,主要痛苦就是建立这个sqlite
的内容,也就是索引的制作。这里,苏南大叔放出以下几个链接,大家可以自行查看使用方式。
- https://kapeli.com/docsets#dashDocset 《Any HTML Documentation》
- https://github.com/alexblunck/Dash-Docset-Creator
- https://github.com/xuelangZF/html2Dash
dash
也支持导入下载得到的docset
文件,这里不做赘述。
下载完成的文档位置
可以通过选项中的docsets
选项卡,看到所有已有的文档。但是如果追根溯源的话,具体的硬盘上的文档物理位置,如下图所示:
~/Library/Application Support/Dash/DocSets
文档查询
这个dash
其实有个特殊的语法,可以用于查询某个特定的文档中的资料。下图展示的就是在php
这个文档中查询ltrim
相关资料的过程。
:php ltrim
当然,还支持自定义的网站接口查询,还是非常方便的。
总结
dash
和zeal
,还是有想象的余地的。目前,本篇文章就是个简单的介绍。苏南大叔计划在将来,再仔细讲讲新的自定义文档的制作问题。如果您有相关方面的需求或疑惑,请点击下面的链接查看:
本博客不欢迎:各种镜像采集行为。请尊重原创文章内容,转载请保留作者链接。