Image CC-BY-SA by mikecogh on Flickr.
During this course you will learn the theoretical and technical parts by creating your own online course! Applause!
This course is built using GitHub Pages, to make a copy of this course, you need to fork the repository on GitHub. You can do this by clicking the link below. You may need to log in or create a GitHub account.
This copy is where you will be working during the rest course. Some of the technical things may be challenging or frustrating, but by tackling it bit by bit and asking your peers for help, you’ll soon be an expert and helping other people!
There are two updates that you need to make to your course to get it working. First, change
baseurl:
to
baseurl: /course-in-a-box
in the file https://github.com/your-github-username/course-in-a-box/blob/gh-pages/_config.yml
Next, delete the file called CNAME https://github.com/your-github-username/course-in-a-box/blob/gh-pages/CNAME
Now that you have a space to work, lets put a draft framework in place for your course.
To update the title of your course, go to https://github.com/your-github-username/course-in-a-box/ and edit the file called _data/course.yml
. You will see the title for this course there, change that to the name you decided on. Don't worry too much if you don't have the perfect name, you now know how to change the title for your course and you can update it at any time!
title: "Course Title"
Will they be building something during the course. Put this basic information on the front page of the course to give a short overview of what to expect. To update the info on the front page, go to the file https://github.com/your-github-username/course-in-a-box/blob/gh-pages/index.markdown and replace the text currently there to reflect what your course will be about. Once again, you can update it at any time and we will come back to this at a later stage.
You can view it by going to https://your-github-username.github.io/course-in-a-box/, just replace your-github-username with your GitHub username.
You may have noticed that the https://github.com/your-github-username/course-in-a-box/blob/gh-pages/index.markdown file contained a few funny caracters. This is called Markdown, an easy way of writing files for the web. For some tips on how to get the most out of Markdown, see our Markdown cheetsheet.
Possible error: pages not displayed. You can get an email after forking the repository with the following message: "The page build failed with the following error: Page build failed". To solve this issue, check you have enabled the automatic page generator on your repository. Another possible cause would be a missing whitespace in your newly added content. Double check it and commit again to trigger page generation.