Jekyll architect theme not working on GitHub page

Question

I created a GitHub page with a repository called myusername.github.io I cloned that (empty) repo to my PC and using jekyll command line I created a new blog inside of this folder. It was building correctly on my PC and on GitHub with the standard theme 'minima'. However, I wanted to use the 'architect' theme and followed their instructions (just add theme: jekyll-theme-architect on the _config.yml) to use it but got a messed up page as a result. What is going on? How can I fix that?

I am totally pissed off by this. The instruction is so simple, but does not work!!!

Answer 1

This is due to not having the proper gem locally, so you can install the gem explicitely or add the github-pages gem that contains that theme as it is supported by Github pages.

Add the following to your site's Gemfile:

gem "github-pages", group: :jekyll_plugins

then run bundle install.

Edit index.md and change the layout to the default one: layout: default.

Remove the lines that contains an include tag in about.md for example: {% include icon-github.html username="jekyll" %}.

and you will be able to use the new theme.