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.
The flagship functionality of GitHub is “forking” – copying a repository from one users account to another. This is what we will do with this repository of content. By forking repository you will copy the Course in a Box content from our repository, and modify it under your own account and then publish with your own link to it.
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.
When we asked you to fork this course you actually copied this course and started building your own!
This copy is where you will be working during the 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
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/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!
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/.