Exercise: GitHub Pages #1

Activity

1. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Author

   More actions

   Step 1: Enable GitHub Pages

   📖 Theory: What is GitHub Pages?

   GitHub Pages lets you turn your repository into a website. This is a great way to share your project, resume, portfolio, documentation, or even a blog with the world.

   When you enable GitHub Pages on a repository, GitHub takes the content that's on the main branch and publishes a website based on its contents.

   Note

   Learn more in the GitHub Pages documentation.

   ⌨️ Activity: Enable GitHub Pages

   1. Open this repository in a new browser tab so you can work on the steps while you read the instructions in this tab.

   2. Under your repository name, click Settings.

   3. Click Pages in the Code and automation section.

   4. Ensure Deploy from a branch is selected from the Source drop-down menu, and then select main from the Branch drop-down menu.

   5. Click the Save button.

   6. With GitHub Pages enabled Mona will be preparing the next step in this exercise!

   Having trouble? 🤷

   
   

   • Turning on GitHub Pages creates a deployment of your repository. GitHub Actions may take up to a minute to respond while waiting for the deployment. Future steps will be about 20 seconds; this step is slower.
2. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Author

   More actions

   

   Please, follow the steps above.
   I'll watch your progress in the background to provide feedback. 🧐
3. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Author

   More actions

   

   🎉🎉🎉 Nice work! Everything is perfect! 🎉🎉🎉
   Preparing content for step 2! One moment... 🤓
4. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Author

   More actions

   Step 2: Customize your homepage

   Good job! You turned on GitHub Pages! 🎉

   You can see the link to your website at the top of the Pages section of your repository settings (you may need to refresh it)

   Tip

   Keep your GitHub Pages website open in a separate browser tab and keep it handy!

   As you progress through this exercise, you'll see your changes reflected on your live site.

   📖 Theory: Customizing your homepage

   You can customize your homepage by adding content to index.md file. As you commit it to the main branch your website will be updated to display your personalized content!

   ⌨️ Activity: Create your homepage

   1. Browse to the index.md file in the main branch.
   2. In the upper right corner, open the file editor.
   3. Type the content you want on your homepage. You can use Markdown formatting on this page.
   4. (optional) You can also modify title: or leave it as it is.
   5. Commit your changes to the main branch.
   6. As you commit your changes Mona will prepare the next step in this exercise!

   Having trouble? 🤷

   
   

   • Make sure you are editing the index.md file in the main branch.
5. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Author

   More actions

   

   Please, follow the steps above.
   I'll watch your progress in the background to provide feedback. 🧐
6. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Author

   More actions

   

   🎉🎉🎉 Nice work! Everything is perfect! 🎉🎉🎉
   Preparing content for step 3! One moment... 🤓
7. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Author

   More actions

   Step 3: Configure your site

   Nice work updating your home page ✨

   It's time we give it a little bit of configuration so it looks nice!

   📖 Theory: Jekyll and _config.yml

   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. Learn more in the Jekyll configuration documentation.

   For this activity, we will use a blog-ready theme named "minima".

   ⌨️ Activity: Configure your site

   1. Browse to the _config.yml file in the main branch.

   2. In the upper right corner, open the file editor.

   3. Add a theme: set to minima so it shows in the _config.yml file as below:

      theme: minima

   4. (optional) You can modify the other configuration variables such as title:, author:, and description: to further customize your site.

      Example

      
      

      theme: minima
      title: Theo-Geo's personal blog
      description: This is where I share cool stuff about my life
      author: Theo-Geo

   5. Commit your changes to the main branch.

   6. As you commit your changes Mona will prepare the next step in this exercise!

   Having trouble? 🤷

   
   

   • Make sure you are editing the _config.yml file in the main branch`.
   • Double-check your YAML formatting. Indentation and colons matter!
8. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Last edited by github-actions

   Author

   More actions

   Step 3 - Passed ✅

   

   Status	Description
   ✅ - Pass	Looked for minima theme added to the configuration file
9. github-actions commented on Jun 9, 2026

   

   github-actionsBot

   on Jun 9, 2026 – with GitHub Actions

   Author

   More actions

   

   🎉🎉🎉 Nice work! Everything is perfect! 🎉🎉🎉
   Preparing content for step 4! One moment... 🤓
10. github-actions commented on Jun 9, 2026

    

    github-actionsBot

    on Jun 9, 2026 – with GitHub Actions

    Author

    More actions

    Step 4: Create a blog post

    Your home page is looking great! 🤠

    📖 Theory: Jekyll blog posts and frontmatter

    Jekyll uses specially named files and frontmatter to create blog posts. The files must be named _posts/YYYY-MM-DD-title.md and must include title and date in the front matter.

    Front matter is a yaml section at the top of your file that looks like this:

    ---
    title: "Welcome to my blog"
    date: 2025-05-15
    ---

    Note

    Learn more in the Jekyll frontmatter documentation.

    ⌨️ Activity: Create a blog post

    1. Browse to the main branch.

    2. Click the Add file dropdown menu and then on Create new file.

    3. Name the file following the _posts/YYYY-MM-DD-title.md format.

    4. Replace the YYYY-MM-DD with today's date, and change the title of your first blog post if you'd like.

       If you do edit the title, make sure there are hyphens (-) between your words.
       If your blog post date doesn't follow the correct date convention, you'll receive an error and your site won't build. For more information, see "Page build failed: Invalid post date".

    5. Type the following content at the top of your blog post:

       ---
       title: "YOUR-TITLE"
       date: YYYY-MM-DD
       ---

       1. Replace YOUR-TITLE with the title for your blog post.
       2. Replace YYYY-MM-DD with today's date.

    6. Type a quick draft of your blog post. Remember, you can always edit it later.

    7. Commit your changes to the main branch.

    8. As you commit your changes Mona will prepare the next step in this exercise!

    Having trouble? 🤷

    
    

    • Double-check your file name and date format.
    • Make sure your frontmatter is at the very top of the file and formatted correctly.
11. github-actions commented on Jun 9, 2026

    

    github-actionsBot

    on Jun 9, 2026 – with GitHub Actions

    Author

    More actions

    

    Please, follow the steps above.
    I'll watch your progress in the background to provide feedback. 🧐