docset-generator

Dash 文档生成器

制作好的文档我会传到 Release 如果有刚好需要的可以直接使用。

制作方式

1. 镜像站点

镜像工具有很多，不过我只推荐使用 HTTrack

支持的平台：OS X / Windows/Linux/Unix/BSD

镜像站点的时候要注意排除无关的资源和链接，比如 Vue 的文档导向了 Github 仓库，我们就需要将其排除。

另外由于镜像站点会给对应的站点带去不必要的负担，所以还是建议限制下镜像的速度。

如果官方已经提供了离线的文档那么就可以直接使用，不需要再镜像站点。

HTML 的文档和 CHM 的文档都可以制作成 Dash 文档，CHM 文档解包后可以得到 HTML 文档，但是需要注意将文件编码转换成 UTF-8。

2. 放入指定的路径

依次将资源重命名并放入 docs 和 icons 目录

3. 编写生成的配置文件

在 config 文件夹创建对应名称的 js 文件。本工具已经将 Dash 文档制作的过程简化了，您只需要编写生成 目录索引 和 过滤器 的代码。

参数

insertToDb 会将目录插入到 Dash 文档的 SQLite 数据库中，使用 Dash 开启文档的时候会在侧栏显示索引。

addDashAnchor 是添加对应 Dash 锚点的函数

$ 是解析 HTML 后的 Document，具体使用方法查阅 cheerio

docset 是用户传入的配置，对应 config 的 export

relativePath 是相对路径

钩子

执行顺序从上到下：

beforeParse({ path, html }) 在解析 HTML 之前执行，需要返回 HTML

beforeGenerateToc({ $, relativePath, addDashAnchor, docset }) 在生成目录之前执行

generateToc({ $, relativePath, addDashAnchor, docset, insertToDb }) 生成目录，只有该方法可以插入到数据库

beforeFilter({ $, relativePath, addDashAnchor, docset }) 前置过滤器

filter({ $, relativePath, addDashAnchor, docset }) 过滤器

afterFilter({ $, relativePath, addDashAnchor, docset }) 后置过滤器

beforeWrite({ path, html }) 在 HTML 写入到文件之前执行，需要返回 HTML

具体请自行查看样例进行编写。