Summary and Schedule
This lesson guides you through making websites using Haunt on a web hosting service GitHub Pages. If you are comfortable interacting with websites in a web browser, this lesson is for you. Basic understanding of HTML as a webpage authoring languages is welcome but not a must.
For those already familiar with the ways that version control systems and an online platform like GitHub can help them track and compare changes to flat text files, and collaborate with others on projects, GitHub Pages, Codeberg Pages, GitLab Pages and Sourcehut Pages provide a way to build and host webpages.
This approach is commonly used to provide documentation for software projects, and to create blogs and websites for individuals and organisations already used to working with version control for their other projects.
However, for those taking their first steps towards building sites like this, the process can be confusing and intimidating. This tutorial aims to address this, by providing a step-by-step guide to creating a collection of pages and combining them into a coherent site using a framework called Haunt.
Outdated Screenshots
Throughout this lesson we will make use and show content and screenshots from GitHub.com. As an ever evolving platform, GitHub is always adding new features and new visual elements to its website.
Screenshots in the lesson may then become out-of-sync, refer or show content that no longer exists.
If during the lesson you find screenshots that no longer match what you see in your browser, please open an issue describing what you see and how it differs from the lesson content. Feel free to add as many screenshots as necessary to clarify the discrepancy.
Setup Instructions | Download files required for the lesson | |
Duration: 00h 00m | 1. Introduction |
“What is static web content?” “Why should I use GitHub or GitLab Pages to create my website?” |
Duration: 00h 40m | 2. Hosting Websites on GitHub | “How do I publish my page or a website on the Web via GitHub?” |
Duration: 01h 20m | 3. Starting With Haunt |
“How can I create a static website with Haunt?” “How can I configure values/settings for my site?” |
Duration: 01h 50m | 4. Authoring With Skribe |
“How can I write content for my webpages?” “How do I link to other pages?” |
Duration: 02h 25m | 5. References | What common terms are relevant to this lesson? |
Duration: 02h 25m | Finish |
The actual schedule may vary slightly depending on the topics and exercises chosen by the instructor.
GitHub
Prior to the workshop you will need to setup a free account for GitHub. Please consider what personal information you’d like to reveal in your account. For example, you may want to review these instructions for keeping your email address private provided on GitHub.