在Mac电脑上为Dash制作docSet文档

Dash是mac上的一款查看API的工具,里面可以直接下载大部分的API文档,但是有时候我们如果想把自己手里已有的文档也集成到Dash中,就需要我们自己动手了,其实Dash官方也有教程如何制作docSet的,地址是:http://kapeli.com/docsets  (7. Any HTML Documentation) , 本文是我照着官方的教程,把流程步骤一步一步的记录下来的,大家可以参考一下。


Dash所需的文档都是docSet文件,其实docSet文件就是一个文件夹而已,这个文件夹里面放了最终的html文档,以及根据这些html建好的索引(索引是放在sqlite数据库中),很简单。


下文我以mysql5.1官方的中文文档(html)为例,来说明如何根据html文档一步步创建docSet

1. 从mysql的官网上下载5.1的html中文文档,下载地址为: http://downloads.mysql.com/docs/refman-5.1-zh.html-chapter.zip , 下载后解压缩,会发现里面全都是一些html文件,其中有2个需要关注,一个index.html,一个是ix01.html,第一个是首页的目录,第二个是所有的索引列表,这2个文件里基本上包括了所有的mysql索引,我们后面就要把这2个文件里的内容按dash要求的格式来建立索引。

2. 建立文件夹。本例中我们创建的文档就叫mysql51吧

你可能感兴趣的:(mac,web,Dash,docSet,Mac,mysql)