Making a Free Webpage with GitHub Pages
In this workshop, attendees will learn how to host free webpages on GitHub. The process to make a basic, single page site is surprisingly easy and provides an excellent alternative to paid hosting options as not only is it free, but it allows for full control over the site at all times and it will exist forever! This workshop is the third in the GitHub Workshop Series offered by the Brock University Digital Scholarship Lab.
A basic understanding of using repositories in GitHub is recommended for this workshop.
Estimated workshop length: 1.5 hours
In preparation for this workshop, you will need the following:
- A GitHub account which you can get by clicking the “Sign Up” button at the top right of https://github.com/.
- A GitHub repository that you will use to build a GitHub pages site. A new repository with just a README.md file will work fine.
- An image file (jpg or png work best) to add to your site.
Markdown Cheat Sheet: This is a helpful cheat sheet showing the common Markdown syntax. Excellent for experienced users and beginners alike!
Task Set 1
- Navigate to your GitHub repository and add an image of any kind using the “Add file” button
- Edit your README file and add at least two sizes of heading (Use #’s), some bold text (Use **), some italic text (Use *), a link to a web location of your choice (Use ), and add your image to your page (Use and remember that if the file is in a folder you need to use its full path)
- Try out some of the other elements shown in the Markdown Cheat sheet (I am personally a fan of using “Horizontal Rule” to break up pages and “Footnotes” for in text citations or references)
- Once you have finished editing your README file and are happy with the preview, commit your changes with an appropriate commit message
- Once you have done all that, type “MARKDOWN MASTERED!!!!” in the chat to let me know you are ready to move on
Task Set 2
- Navigate to your repositories settings using the “Settings” tab and then click on “Pages” in the menu on the left
- Choose a theme for your site by clicking on the “Change theme” button, picking the theme you want, and then clicking the green ”Select theme” button at the top right of the page
- Set the source for your site to the “main” branch from the dropdown menu and the click “Save” to start building you site.
- Wait a couple minutes then click the link to see your new webpage! Feel free to share the link to your page in the chat for others to see!
- Once you have admired your site, type “SITE CREATED!!!!” in the chat to let me know you are ready to move on
BONUS! Try making another Markdown file and making a link to and from your main page and that new page
After completing this workshop, the recommended next steps are:
- Try making another site from scratch. Practicing the steps and getting more comfortable with Markdown will help keep the knowledge gained in the workshop from fading away!
- Check out Hugo and Jekyll to learn more about more advanced theme options.
- Check out the other workshops in our introduction to GitHub Series
This workshop is brought to you by the Brock University Digital Scholarship Lab. For a listing of our upcoming workshops go to Experience BU if you are a Brock affiliate or Eventbrite page for external attendees.