Tutorial 11: Themes

HOME

---

Tutorial 11: Themes

SWITCHING THEMES IS NOT RECOMMENDED UNTIL FULLY UNDERSTAND THE POTENTIAL PROBLEMS!

Minima is not a native GitHub Page theme. It will cause a lot of headaches! See also starting https://youtu.be/NoRS2D-cyko?t=282 for more details.

Themes

1. Find a theme at https://rubygems.org/search?query=jekyll-theme

2. Preview a theme. Example: jekyll-theme-hacker

3. Switch theme in the _config.yml file:

   theme: jekyll-theme-hacker
   

4. Modify Gemfile file:

   source "https://rubygems.org"
   # gem "github-pages"
   gem "jekyll"
   gem "minima"
   gem "jekyll-theme-hacker"
   gem "jekyll-feed"
   gem "tzinfo-data"
   

5. Execute:

   bundle install
   

6. Grep:

   grep layout: *.md *.html */*.md */*.html
   

7. Change all layouts to “default”

8. Example file _config.yml:

title: GitHub Pages, Ubuntu, and Jekyll
description: >-
  (V039 20210731) Just, GitHub Pages, Ubuntu, and Jekyll
author: "Mr. Yoda-Yoda"
theme: jekyll-theme-hacker
github
  - metadata