dash html中文文档,Dash Docset 创建指南

8种机械键盘轴体对比

本人程序员，要买一个写代码的键盘，请问红轴和茶轴怎么选？

Dash 是 Macos 上一款热门的API查询工具，可以用来查询很多常用语言/框架的官方文档。Windows 平台有类似的应用zeal和velocity。

本文基于Dash官方文档所写，如有错误欢迎指正。

从其他文档格式转换

Docset 支持从其他标准文档格式转换。

Python 文档(Sphinx、PyDoctor) 可以使用doc2dash模块转换。另外还需用到sphinx模块。两个模块均使用pip安装。

由于直接转换格式比较容易，此处不赘述，具体步骤可以参考官方文档。

从HTML 中提取转换

有些文档只有HTML 版本，比如笔者需要的PyQt4的本地文档。由于HTML文档没有统一的格式，要从HTML转换到Docset需要自己写程序。

根据官方的步骤：

创建Docset 文件夹

Mac下使用如下命令创建：

mkdir -p .docset/Contents/Resources/Documents/

Windows 下直接新建这几级文件夹，最顶层文件夹名最后要加上.docset

将HTML 文档放入文件夹下

第二步是把本地的HTML文档放入刚刚创建的 .docset/Contents/Resources/Documents/ 文件夹下。