shawe/github-pages-with-jekyll

Welcome

Closed this issue · 1 comments

github-learning-lab commented

Step 1: Enable GitHub Pages

Welcome to GitHub Pages and Jekyll 🎉!

Hello, and welcome! If you are here to learn how to quickly build and host a GitHub Pages site. You're in the right place.

What are GitHub Pages?

GitHub Pages enable you to host all kinds of content, like documentation, resumes, and more! In this course, you will be creating a blog hosted on GitHub Pages. While setting up your blog, you'll learn how to:

  • Enable GitHub Pages
  • Use Jekyll
  • Customize Jekyll sites with a theme and content

New to GitHub?

We're assuming that you already know how to work with GitHub. If you aren't sure, check out the Introduction to GitHub course to learn how to:

  • Create a branch
  • Make commits
  • Open a Pull Request

Now, let's get started on your new website.

⌨️ Activity: Turn on GitHub Pages

You won't be able to see your site on the web until you enable GitHub Pages on this repository. All we're doing is asking GitHub to take what's on the master branch and publish a website based on its contents.

  1. Click on the Settings tab for this repository
  2. Scroll down to the GitHub Pages section
  3. Select the None dropdown
  4. Click on Master branch
  5. Click Save

For a printable version of the steps in this course, check out the Quick Reference Guide.

Turning on GitHub Pages creates a deployment of your repository. I may take up to a minute to respond as I await the deployment.

Return to this issue for my next comment

Sometimes I respond too fast for the page to update! If you perform an expected action and don't see a response from me, wait a few seconds and refresh the page for your next steps.

github-learning-lab commented

Step 2: Customize your homepage

Great job! Now that GitHub Pages are enabled, you'll be able to view your website here: https://shawe.github.io/github-pages-with-jekyll

Your site doesn't look like much yet, but don't worry. We're going to make it look amazing.

GitHub Pages looks for one of two files to serve as the home page of your site. First, it looks for a file named index. If it doesn't find one, it looks for the README.md.

You already have an index.md file so let's update it to include your personalized content.

⌨️ Activity: Create your home page

  1. On the Code tab, click the index.md file
  2. Click the ✏️ pencil icon to enter edit mode and add a few lines of content. Remember, you can use Markdown
  3. Scroll the bottom and select the option to "Create a new branch for this commit and start a pull request"
  4. Select Propose file change
  5. Write some text in the "Leave a comment" field of the pull request
  6. Click Create pull request

Once you have created your pull request, I will move over there to discuss next steps.

Look for my next response in your pull request