Now you should be able to browse your blog at After you see the blog, you will probably be tempted to modify some colors, fonts or other CSS properties. Once you done with updating layouts, includes and _config.yml, run a development server on your local machine: bundle exec jekyll serve Now you need to change theme in the _config.yml file: theme : jekyll-theme-caymanĪpart of that you might also need to add some additional settings to the _config.yml file - settings, that used by the new theme that you are switching to.įor example, for Cayman theme I needed to add repository: sergodeeva/ to my _config.yml. For example, I created the following includes: head.html, header.html, footer.html. Using includes also improves the readability of your layouts’ code.Ĭreate _includes folder in the root directory of your site, and place includes files inside.
#Jekyll install theme code#
If you have some code snippets that you want to include in multiple layouts of your site, save the snippets as include files and insert them where required, by using the include tag. To solve issue with missing layouts, in your blog’s root directory create a _layouts folder, and inside that folder create 4 layout files. That is why after a switch from Minima to Cayman there was a blank page instead of my blog’s homepage (because home.html layout was missing). For example, Cayman theme that I switched to only had default.html layout. Whenever you switch to a new theme, the new theme might have a different set of layouts.
#Jekyll install theme update#
Run bundle update command in Terminal to update all gems. Navigate to Gemfile in the root directory of your Jekyll site, remove gem jekyll and add github-pages gem: # gem "jekyll", "~> 3.6.2" gem "github-pages", group: :jekyll_plugins Make sure you have Jekyll installed (if not, follow the installation instructions).Īs we are going to use GitHub Pages, make sure you have created a GitHub repository with a name. Thus I decided to write a post about switching Jekyll theme, hope it will help you to save some time.
Although there are a lot of instructions available on the Internet, I spent a couple of hours dealing with various errors during the switch. I was recently switching a theme for my blog from Minima to Cayman and found it not very obvious. However you can choose from one of many custom themes supported by GitHub Pages: official Jekyll themes, as well as open source Jekyll themes hosted on GitHub. A new Jekyll site out of the box uses a default gem-based theme called Minima.