tl;dr?

We have recently put a GitHub Enterprise Server into operation. For administrative purposes, we have some workflows around the GitHub Enterprise Server. To gain more knowledge, I had to dive a little deeper into GitHub / GitHub Enterprise Server. During my learning experience, I stumbled upon the possibility to run blogs / website on GitHub. Below is a very simple description of how such a blog can be implemented using the Ruby web framework Jekyll.

Create appropriate repository

In your GitHub account create a repository named <github_username>.github.io. If you push some Jekyll code into this repo, GitHub will render the site and it is available via the link http://<github_username}.github.io, e.g. http://florianmaier101178.github.io.

Installation of jekyll on ubuntu linux

$ sudo apt install -y ruby-dev
$ sudo gem install jekyll

Setup of blog

$ jekyll new florianmaier101178.github.io
$ cd florianmaier101178.github.io
$ git init .
$ git remote add origin git@github.com:florianmaier101178/florianmaier101178.github.io.git
$ git push origin master

Run the blog locally

$ jekyll serve
$ open http://localhost:4000

Minima theme

The blog is based on the minima theme. I did some customizations of the footer and the main page. These adaptions are applied in the subdirectories _includes and _layouts of the repository. Both directories are copied from the minima code.