Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Change of theme ends up with Jekyll error #416
Before submitting an issue, please be sure to
This issue affects
What did you do (e.g., steps to reproduce)
I created a pages site and tried to change theme from minima to jekyll-theme-dinky. And then ran the usual steps.
As it did not work I tried to modify it online at github with the settings tool for automatically changing the theme of the site.
What did you expect to happen?
Github page to work as usual with the modified theme.
What happened instead?
For my local site I got the following error:
For the github-pages automatic theme changer I got only:
I did some research and found out that this was fixed for jekyll 3.4.0, and was generated by issue Jekyll issue number 5750. However Github-pages has dependencies on Jekyll 3.3.1 and I could not force the local site to be build at least on 3.4.0.
@OneGneissGuy I've updated my earlier comment for clarity. You need to remove the references to includes
Locally when I run :
about.md and index.md here:
The issue seems to be with one of the plugins used by GitHub Pages. For now, if you want to switch to any other theme supported on GitHub Pages, simply add a
Note: You need to remove this directory if you ever decide on using default Minima again
added a commit
Aug 1, 2017
pushed a commit
Sep 8, 2017
For anyone running in to this issue under different circumstances, this error can also occur because of unconventional frontmatter naming schemes across different themes.
For instance, when setting up a new site let's say you use the sample post from
If you decide to apply, say, the 'Minimal Mistakes' theme (https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/), this error will pop up on build.
This happens because your build is requesting the 'post' layout as defined in the sample frontmatter, which does not exist in this particular theme. A quick look at the Minimal structure tab --
-- shows us that in this particular theme we need to specify the 'single' layout for posts, not 'post'.
Making this change to our post frontmatter resolves the issue and allows us to build without error.
The takeaway is: remember that naming conventions are not uniform. This is one of the great things about Jekyll--that pretty much anything is editable--but it also means that things like this happen when we stray from convention in our customizations.