默认配置

增量生成

增量生成仍是一项实验性功能

虽然增量生成适用于大多数常见情况,但它并不是在所有情况下都能正常工作。使用此功能时请务必极其谨慎,并通过 在 GitHub 上提交问题 报告以下未列出的任何问题。

增量生成通过仅生成自上次生成以来已更新的文档和页面来缩短构建时间。它通过在 .jekyll-metadata 文件中同时跟踪文件修改时间和文档间依赖关系来实现此目的。

在当前实现中,增量生成仅在文档或其依赖项之一被修改时才会生成文档或页面。目前,跟踪的唯一依赖项类型是包含(使用 {% include %} 标记)和布局。这意味着对其他文档的普通引用(例如,在文章列表页面中迭代 site.posts 的常见情况)将不会被检测为依赖项。

为了弥补这些不足,在文档的页首信息中放置 regenerate: true 将强制 Jekyll 重新生成该文档,无论它是否已被修改。请注意,这将仅生成指定的文档;对其他文档内容的引用将不起作用,因为它们不会被重新渲染。

增量生成可以通过命令行中的 --incremental 标志(简称 -I)启用,或通过在配置文件中设置 incremental: true 启用。