Dash

    • 支持任何一个你想管理的文档（iOS/Mac/PHP/Python/Java/jQuery/Backbone.js 等等）
    • 支持自定义生成你想要的文档（AppleDoc/JavaDoc/RDoc/Doxygen/pydoctor/Sphinx/Scaladoc）
    • 自动升级文档版本
    • 快捷键搜索文档及 API
    • 无缝插入众多第三方应用（Alfred，XCode，Terminal，Eclipse，甚至任意的 App）

    Dash Feature

    这块已经有人介绍了，我就不多说了：

    Dash 本身只支持 docsets 格式的文档，也就是由 appledoc 生成的。默认是让 XCode 的 Organizer 管理文档，但是针对这个庞然大物，只是做文档的管理和快速搜索有消受不起。因此 Dash 才诞生出来的。

    其实本篇日志主要是讲这块的内容，从上面的特性上面我也说到 Dash 支持生成任何的文档，因为它支持的文档类型涵盖了目前绝大多数的文档格式，针对这块官方已经写了，这里简单说明下：

    语言转换工具

    Python, Sphinx, doc2dashpydoctor

    Javadoc

    RDoc
    使用 Dash 自身的 “Ruby Installed Gems”

    Scaladoc
    mkscaldocset

    Doxygen(源码)
    修改参数生成

    docsetutil
    需要创建指定目录结构

    因为最近在学习 Flask，过年回家家里没有网络，因为我需要可以查询它的文档，虽然官方提供了 html 和 pdf 格式，但是没有办法快速搜索 API，没法发挥 Dash 的优势嘛，对吧！

    Flask 官方提供的 html 文档是 Sphinx 格式的，首先把下载到本地，并安装好 doc2dash，另外备好一个 flask icon。

    因为 Dash 可以让每个文档都有自己的 Icon，否则默认只是 docset 的 Icon，下载完毕之后，执行代码：

    其中 --add-to-dash 是生成完毕后自动添加到 Dash，默认生成好的 docset 文件在当前目录。

    好了，Dash 已经可以索引到所有的 Flask API 了，真是太 TMD 的酷了！

    如果你希望把自己生成的文档分享出来，并提供后期的维护升级，你可以提供一个 feed 保持文档的自动更新，这里有。

    • 你可以提供多个 url 多备份提供文档下载
    • 支持 tgz 格式的打包