Hosting Parsons on Github Template

This repo is a template to help you quickly and easily host Parson's problems on GitHub.

You can use Codio's graphical Parson's problems generator to create the Parson's problems and paste them into this template. Visit the other repo's main page for help on using the generator.

How to host your own Parson's Problems

1. Create a Github account (if you don't have one already). A free account works great for this!

2. Fork this repo using the "Fork" button

   

3. In your fork (it should have your user name after the github.com/ in the URL bar) click on "Settings":

   

4. Set the GitHub Pages Source to Master branch using the drop down:

   

Test your repo

1. To check that your repo is now setup correctly, return to the "Code" tab on the far left (you can get there by clicking on the repo name at the top too).

2. Click on the environment button with the rocketship icon

   

3. Click on the "View Deployment" button - the one at the top is the most recent.

   

4. You should be re-directed to a page with the example Parson questions that looks like this

   

How to Add Generated Parson's Problems

1. Use Codio's graphical Parson's problems generator to create a Parson's problem

2. Click EXPORT in the top left

3. Click Switch to Code

4. (optional) If you are hosting multiple parsons problems on the same page (in the same markdown) then add a unique pre-fix in the textbox at the top and press enter.

5. Copy the code into a markdown file on Github