404 errors on category and tag pages

I’m using the jekyll-category-pages and jekyll-tagging gems on my website. When I run the site locally, category and tag pages show up with no issues, but when I try to navigate to them on the GitHub Pages build, I get 404 errors. Any help with this issue would be appreciated.

I believe Github Pages only supports a pre-define set of plugins, See:

It seems you can add additional ones on top of the default plugins, but if only the pre-defined set is supported then that’s a real shame.

Yea, it’s a shame. I’m guessing the reason Github doesn’t allow unapproved plugins is due to the dangers of arbitrary code execution (i.e. villainous crypto-miners are the reason we can’t have nice things (for free)).

There are possible work-arounds. For example:

  • Use Github Actions to build the site with Jekyll and push the generated static content to a repo for serving by Github Pages.
  • Use another service to build/host the site, such as Netlify, which may allow arbitrary plugins.

How do I go about the first work-around exactly?

I’ve never done it myself, but it’s documented at:

1 Like

I eventually made use of the Jekyll Deploy Action workflow and everything’s working fine on my site now.

Thanks for your help!

1 Like