cfq20/jekyll-tutorial

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 is enabled, you can view your website here: https://cfq20.github.io/github-pages-with-jekyll

You can customize your homepage by adding content to either an index file or the README.md file. GitHub Pages first looks for an index file. If an index file is found, GitHub Pages uses the content in the file to create the homepage. If an index file isn’t found, it uses the README.md to create the homepage.

Your repository has an index.md file so we can update it to include your personalized content.

⌨️ Activity: Create your homepage

  1. Navigate to the Code tab of this repository, and browse to the index.md file.
  2. In the upper right corner, click the ✏️ pencil icon to open the file editor.
  3. Type the content you want on your homepage and remember, you can use Markdown to format your content.
  4. Scroll to the bottom, type a commit message, and click Create a new branch for this commit and start a pull request.
  5. Open a 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