Jekyll 配置增量生成 Incremental regeneration

增量生成 / 增量更新 / 增量构建

可以通过命令行上的 --incremental 标志(缩写为 -I)或在配置文件中设置 incremental: true 来启用增量生成功能。

增量生成仍处于实验阶段

虽然增量生成在大多数情况下可以正常工作,但并不保证适用于所有场景。使用此功能时请特别小心,并且如遇到未列出的问题,请通过Jekyll 的 GitHub 提交问题进行反馈。

增量生成构建时间更短,它能够通过记录文件修改时间和文档之间的依赖关系(保存在 .jekyll-metadata 文件中),帮助加快构建速度。它只重新生成自上次构建以来有修改过的文档和页面。

当前的实现方式是,只有当文档或页面本身或它们的依赖项(比如使用 {% include %} 标签的内容或布局)被修改时,增量生成才会重新生成。但是需要注意的是,对其他文档的简单引用(例如,在文章列表页面中遍历 site.posts)并不会被视为依赖项。

为了弥补这些不足之处,在文档的页面头部参数(front-matter)中加入 regenerate: true,无论文档是否已被修改,Jekyll 都会强制重新生成它。需要注意的是,这只会重新生成当前文档;对其他文档内容的引用不会生效,因为它们不会被重新渲染。