Building this site in Github Pages

2018-02-24 193 words One minute

Contents

Outdated - this site is not longer hosted on github not is it using jekyll.

The following are instructions to build this site. Largely it is an exercise in both verifying the steps for myself and in using the site building tools to create and publish this post.

These instructions are based on building a user or organisation site, rather than a project site.

Create initial site

Create Repository: kemitix.github.io
Browse to the Settings page
Scroll down to GitHub Pages
Tick Enforce HTTPS

Create local Jekyll project

1
2
3
4


sudo apt install ruby-dev
sudo gem install jekyll bundler
jekyll new kemitix.github.io
cd kemitix.github.io

Configure So Simple theme

Add plugins to Gemfile:

1
2
3
4
5
6


gem "github-pages", group: :jekyll_plugins

group :jekyll_plugins do
    gem "jekyll-remote-theme"
    gem "jekyll-sitemap"
end

Install plugin:

1

bundle install

Enable plugins and select theme in _config.yml:

1
2
3
4


plugins:
  - jekyll-remote-theme
  - jekyll-sitemap
remote_theme: mmistakes/so-simple-theme

Review site locally

1

bundle exec jekyll serve --incremental

Open browser: http://localhost:4000/

Publish to github

1
2
3
4


git init
git add .
git commit -m"Initial commit"
git push -u origin master

Open browser: https://kemitix.github.io/