GitHub Pages with Jekyll and Minimal Mistake

My first post on the blog would be setting up a GitHub pages using Jekyll with Minimal Mistake theme.

Getting Started

The instruction on the github are fairly simple. However it may be complicated if you are just starting to use github pages. The blog will be going through what needs to be done to set up your github pages with minimal mistake.

Installation

There is actually a quick start guide. However it is still quite hard to understand if you are using it for GitHub Pages.

1. Create a repository on your GitHub (Does not matter if it is private or public)
   • .github.io
2. Clone or Download Minimal Mistake
   • git clone https://github.com/mmistakes/minimal-mistakes.git
3. Create Folders
   • _posts (contains your blog post)
   • _pages (contains the static page)
   • _drafts (contains unpublished draft)

4. Edit the Gem file

    source "https://rubygems.org"
    gem "github-pages", group: :jekyll_plugins
    gem 'jekyll-include-cache'
   

   
   

5. Remove the unnecessary

Since we clone or downloaded the minimal-mistakes-jekyll repo we can safely remove the following folders and files:

* .editorconfig
* .gitattributes
* .github
* /docs
* /test
* CHANGELOG.md
* minimal-mistakes-jekyll.gemspec
* README.md
* screenshot-layouts.png
* screenshot.png

Configure

You can head to _config.yml to change your title, name, description and set according to what you want.

Settings that you must change:

Line number	Setting	Description
19	title	website title
21	name	Your alias or name
22	description	short description about your website
107 - 154	author	Your details

You can also change the theme as minimal mistake comes with many different build in themes at line 15

Push

Git push or upload on github. Browse to .github.io

Writing a blogpost

All blogpost format need to be YYYY-MM-DD-title.md and inside you must set put in the YAML front matter at the beginning of the post.

---
title:  "Welcome to Minimal Mistakes Jekyll"
date:   2017-12-21
categories: update
tags: jekyll
---

There are just many things you can do with minimal mistake. However this are the steps i took to start writing up using github pages, it’s free, simple to use and easy to maintain.