From e0dbffd2b617535a69558cc31a85e2c3373def7e Mon Sep 17 00:00:00 2001 From: Alex Ball Date: Tue, 9 Dec 2025 09:59:20 +0000 Subject: [PATCH 1/2] Fix typo --- episodes/05-github-pages.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/episodes/05-github-pages.md b/episodes/05-github-pages.md index ef272747..51104efe 100644 --- a/episodes/05-github-pages.md +++ b/episodes/05-github-pages.md @@ -241,7 +241,7 @@ you can use the fork you created there and skip to step 3. remote: ``` - You can visit that link in your browser, but if you go back to your fork in GitHib + You can visit that link in your browser, but if you go back to your fork in GitHub you will also see a button has appeared that says "Compare & pull request". You can click on that button instead if you prefer. From f52d39082ee667c61bece8ab3cea361d9aeef79f Mon Sep 17 00:00:00 2001 From: Alex Ball Date: Tue, 9 Dec 2025 10:05:24 +0000 Subject: [PATCH 2/2] Update section on configuring GitHub Pages Following recent changes to GitHub Pages configuration, this text better describes the new options. Closes #180. --- episodes/05-github-pages.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/episodes/05-github-pages.md b/episodes/05-github-pages.md index 51104efe..2caf88da 100644 --- a/episodes/05-github-pages.md +++ b/episodes/05-github-pages.md @@ -50,23 +50,23 @@ Go to the Pages section of your repository's Settings: ![](fig/github-repo-settings-pages.png){alt="GitHub repository's Pages settings"} -#### Source branch (required) +#### Source and branch -Pages needs to know the branch in your repository from which you want to serve your site. This can be any branch, including `main`. +Pages gives you a choice between using the built-in Jekyll tool for building your website or providing your own tool. +We're going to use Jekyll, so leave the "Source" setting on its default value, "Deploy from a branch". -Select then save the source branch: +Jekyll needs to know the branch and folder in your repository from which you want to serve your site. +There are no particular restrictions here. This means we could develop a resource in one branch or folder, and maintain a website to describe it in another. +But on this occasion, we'll only use the repository for the site. + +Select `main` as the branch, "/ (root)" as the folder, and then save these values: ![](fig/github-repo-settings-pages-branch.png){alt="GitHub Pages source branch menu"} ![](fig/github-repo-settings-pages-save.png){alt="GitHub Pages source branch save"} -#### Theme (optional) - -GitHub Pages provides different themes to visually style and organize your site's content. Choosing a theme is optional, and themes can be interchanged quickly. - -![](fig/github-repo-settings-pages-theme.png){alt="GitHub Pages choose theme"} - -See the [GitHub Pages documentation](https://docs.github.com/en/pages/getting-started-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser) for further information on using themes. +That's all the configuration we need to get started with GitHub Pages, but there are other things you can change, such as the theme used to visually style and organize your site’s content. +If you want to explore further after the lesson, see the [GitHub Pages documentation](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll). ### View your site