Material for a course on MarkDown, GitHub pages & GitHub wikis
Learners will first learn basic Markdown by "live-coding" a basic page in steps with each stage exploring new markdown elements.
Then we take the lessons learned to create an "index.md" page to be the sites Homepage
Create a gh-pages branch for our web-site along with an images folder with some
example graphics
Next we explore the Repository settings page and locate the github page URL and add it
to the Repo landing page. Click on it and inspect our new homepage of our static web-site.
Return to settings and explore the default Jekyll page themes
Add more markdown pages and link to them (including some external links and linking to
the 'local' image files
Move onto the wiki page and learn about creating wikis from the material there (with more live-coding).
Pre-requisites & equipment
We will use the web interface for these lessons so knowledge of Command-line git is not
required (but may still be advantageous).
Learners should register at Github to get a username and have (or have access to) a
computer with a web browser.
An Etherpad (an electronic class whiteboard) may be useful for storing questions to be answered
at a later more convenient point. You can create one (for free) here: https://etherpad.net
Projector attached to Instructors laptop, a white-board & pens and red/green post-its (for
Learners to request aid or indicate completion of exercises) will also be useful.