/docset-generator

:pencil: Dash 文档生成器(内含制作完成的中文文档)

Primary LanguageJavaScriptApache License 2.0Apache-2.0

docset-generator

Dash 文档生成器

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

制作方式

1. 镜像站点

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

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

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

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

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

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

2. 放入指定的路径

依次将资源重命名并放入 docsicons 目录

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

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