Introduction

workshop-template-b is a Jekyll project to create a simple workshop website, with a Bootstrap-based theme, designed for hosting on GitHub Pages (or similar static web options!).

It works best for about five pages of instructions, plus home page, all written in Markdown. The navigation to the main pages is exposed at top and bottom of each page for easy stepping through the lessons.

Why?

Rather than making slides for a workshop, why not make a website? It’s easier to write, access, share, and reuse. GitHub and GitHub Pages makes this pretty easy.

It is a great Open Educational Resource since anyone can make a copy and adapt!

GitHub Pages

One amazingly useful GitHub feature is GitHub Pages. It provides free static web hosting from any repository. GH-Pages is intended to host relatively simple sites for your GitHub portfolio, project, or documentation. Because it is free and a valuable transferable skill, this is a great option for teaching and learning.

Many organizations are using GitHub to collaboratively create and publish public workshop websites. For example: