You’re going to be building your course in GitHub. GitHub is web-based repository hosting service, which allows you to manage your code, and see revisions you’ve made via a good-looking, easy-to-use web interface. It’s newbie-friendly, and a great collaboration tool, which is why we’re using it for Course in a Box.
Your course will live on GitHub (so you don’t need to worry about hosting) and you’ll do all the building work there, but you’ll be able to view it as a web page.
Some of the technical things may be challenging or frustrating, but by tackling it bit by bit, you’ll soon be an expert and helping other people! If you get stuck at any point, be sure to ask the community forum.
The first step is to fork this repository. You may need to create a GitHub account if you don’t already have one. Go ahead and fork the repository below.
Fork this repository on GitHub.
When you forked the repository you copied this course and all it’s content to your own repository! This copy is where you will be working during the course.
There are two updates that you need to make to your course to get it working. First, change
baseurl:to
baseurl: /course-in-a-boxin 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
To update the title of your course, go to https://github.com/your-github-username/course-in-a-box/blog/gh-pages/_data/course.yml 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/.
Still not sure what a repository is, how to fork it or how to update contents? Have a look at the GitHub Glossary for explanations of all of these terms.