As a catchy introduction for developers we created the SlideWiki GitHub page slidewiki.github.io. Because GitHub is a dream of a developer platform, we also wanted to use it to publish our upcoming inventions and hacks. Thus Jekyll is the best solution in order to work with GitHub pages and multiple developers who want to publish content.
The following will descripe how Jekyll is used, how to write your Jekyll blog locally and why we don't use jekyll-bootstrap.
For me Jekyll is the same for GitHub pages as SASS is for CSS.
You write your content with help of the engine - e.g. modularity, reusability, linking - and it's parsed with the engine to your static content.
So you define the style, structure and handling depending on the type and metadata with Liquid, tag it and write pages which contains or link your glistening blog entries.
At the moment we have two pages, one as the entry point with the whole overview of what we think is interesting and the other, which lists all blog entries. These are written in HTML and include both the well know Bootstrap within JQuery and Font Awesome. The blog entrys are written in HTML as well to use the same style as the two pages. We make use of the layout and include mechanisms provided by Liquid but we not using SASS right now.
In order to add your blog entry
git clone firstname.lastname@example.org:slidewiki/slidewiki.github.io.git
cp _posts/2016-05-19-example-post.html _posts/YYYY-MM-DD-name.html
docker run --rm --label=jekyll --volume=$(pwd):/srv/jekyll --privileged=true -it -p 4000:4000 jekyll/jekyll
git commit -am "Added blog entry about \"foobar\"" && git push
As we are using Bootstrap on Jekyll we also took a look at jekyll-bootstrap in order to have Bootstrap built-in. Unfortunately it does not work well with the Jekyll docker container out of the box and it is too heavy at the moment. We will reconsider using it as soon as this blog will be migrated or should be extended with more features.