The following instructions where originally written and included by aksakalli as part of his jekyll-doc-theme. I am keeping this content here to help me, as I further extent this site, and for any others that it may help. Thank you aksakalli.

Getting started with GitHub Pages

GitHub Pages can automatically generate and serve the website for you. Let’s say you have a username/organisation my-org and project my-proj; if you locate Jekyll source under docs folder of master branch in your repo, the website will be served on The good thing about coupling your documentation with the source repo is, whenever you merge features with regarding content to master branch, it will also be published on the webpage instantly.

  1. Just download the source from into your repo under docs folder.
  2. Edit site settings in _config.yml file according to your project. !!! baseurl should be your website’s relative URI like /my-proj !!!
  3. Replace favicon.ico and img/logonav.png with your own logo.

Writing content


Docs are collections of pages stored under _docs folder. To create a new page:

1. Create a new Markdown as _docs/ and write front matter & content such as:

title: My Page
permalink: /docs/my-page/

Hello World!

2. Add the pagename to _data/docs.yml file in order to list in docs navigation panel:

- title: My Group Title
  - my-page

Blog posts

Add a new Markdown file such as and write the content similar to other post examples.


The homepage is located under index.html file. You can change the content or design completely different welcome page for your taste. (You can use bootstrap components)

In order to add a new page, create a new .html or .md (markdown) file under root directory and link it in _includes/topnav.html.