Help for troubleshooting common Jekyll issues.

• Slow build times with incremental regeneration

Step 1: Slow build times with incremental regeneration

Incremental regeneration is used to rebuild only the pages and documents that have been updated since the previous build - in most cases, this will mean since the last time a file was saved.

If you’ve been switching between branches and updating files that many pages are dependent on - like an include - you might notice long build times even if incremental regeneration is enabled.

For example: If an include used in a layout is updated, it can sometimes take 30 seconds or more to regenerate. This is because files dependent on the include are also regenerated when the include is modified.

To fix this, you need to rebuild the site and then re-start the server. This will “clean the slate”, so to speak, thus reducing build times.

1. If you have a Jekyll server running, stop it by pressing Ctrl-C.

2. In the Terminal, build the site:

   bundle exec jekyll build
   

3. After the site is finished building, restart the server with incremental regeneration enabled:

   bundle exec jekyll serve --incremental
   

Last updated: 22 February 2022