diff --git a/.github/steps/-step.txt b/.github/steps/-step.txt index 573541a..0cfbf08 100644 --- a/.github/steps/-step.txt +++ b/.github/steps/-step.txt @@ -1 +1 @@ -0 +2 diff --git a/README.md b/README.md index 296b930..ec059f8 100644 --- a/README.md +++ b/README.md @@ -14,50 +14,34 @@ _Create a site or blog from your GitHub repositories with GitHub Pages._ -## Welcome +## Step 2: Configure your site -With GitHub Pages, you can host project blogs, documentation, resumes, portfolios, or any other static content you'd like. Your GitHub repository can easily become its own website. In this course, we'll show you how to set up your own site or blog using GitHub Pages. +_You turned on GitHub Pages! :tada:_ -- **Who is this for**: Beginners, students, project maintainers, small businesses. -- **What you'll learn**: How to build a GitHub Pages site. -- **What you'll build**: We'll build a simple GitHub Pages site with a blog. We'll use [Jekyll](https://jekyllrb.com), a static site generator. -- **Prerequisites**: If you need to learn about branches, commits, and pull requests, take [Introduction to GitHub](https://github.com/skills/introduction-to-github) first. -- **How long**: This course takes less than one hour to complete. +We'll work in a branch, `my-pages`, that I created for you to get this site looking great. :sparkle: -In this course, you will: +Jekyll uses a file titled `_config.yml` to store settings for your site, your theme, and reusable content like your site title and GitHub handle. You can check out the `_config.yml` file on the **Code** tab of your repository. -1. Enable GitHub Pages -2. Configure your site -3. Customize your home page -4. Create a blog post -5. Merge your pull request +We need to use a blog-ready theme. For this activity, we will use a theme named "minima". -### How to start this course +### :keyboard: Activity: Configure your site - - -[![start-course](https://user-images.githubusercontent.com/1221423/235727646-4a590299-ffe5-480d-8cd5-8194ea184546.svg)](https://github.com/new?template_owner=skills&template_name=github-pages&owner=%40me&name=skills-github-pages&description=My+clone+repository&visibility=public) - -1. Right-click **Start course** and open the link in a new tab. -2. In the new tab, most of the prompts will automatically fill in for you. - - For owner, choose your personal account or an organization to host the repository. - - We recommend creating a public repository, as private repositories will [use Actions minutes](https://docs.github.com/en/billing/managing-billing-for-github-actions/about-billing-for-github-actions). - - Scroll down and click the **Create repository** button at the bottom of the form. -3. After your new repository is created, wait about 20 seconds, then refresh the page. Follow the step-by-step instructions in the new repository's README. +1. Browse to the `_config.yml` file in the `my-pages` branch. +1. In the upper right corner, open the file editor. +1. Add a `theme:` set to **minima** so it shows in the `_config.yml` file as below: + ```yml + theme: minima + ``` +1. (optional) You can modify the other configuration variables such as `title:`, `author:`, and `description:` to further customize your site. +1. Commit your changes. +1. (optional) Create a pull request to view all the changes you'll make throughout this course. Click the **Pull Requests** tab, click **New pull request**, set `base: main` and `compare:my-pages`. +1. Wait about 20 seconds then refresh this page (the one you're following instructions from). [GitHub Actions](https://docs.github.com/en/actions) will automatically update to the next step.