Use Jekyll 3 with GitHub Pages

GitHub Pages does not currently support Jekyll version 3 (2.4 at time of writing, though v3 was recently released and a pull request to the github/pages-gem repo seems ready to roll any day now.

To use Jekyll's collections (with the syntax currently documented on site), I need Jekyll 3, so will build the static site locally rather than let let GitHub do it for me, instead providing just the static site generated under the _site directory.

To switch from Jekyll to Jekyll pre-built:

• push the current non-working state as of the Jekyll 3 version of your site (this will not build, and the prior 2.4 version will still be served) so that there's a backup before modifying the git tree
  • Don't git filter-branch --subdirectory-filter _site -- --all as you the _site/* files will be moved up to the parent and clean out the rest of the repo