CongAn/github-pages-with-jekyll

Welcome

Closed this issue · 1 comments

Step 1: Enable GitHub Pages

Welcome to GitHub Pages and Jekyll 🎉!

If you're new to GitHub Pages, or you want to learn how to build and host a GitHub Pages site, you're in the right place. With GitHub Pages, you can host content like documentation, resumes, or any other static content you’d like.

In this course, you'll create a blog hosted on GitHub Pages and learn how to:

  • Enable GitHub Pages
  • Use Jekyll, a static site generator
  • Customize Jekyll sites with a theme and content

New to GitHub?

Before we can begin, you'll need to know how to create a branch on GitHub, commit changes using Git, and open a pull request on GitHub. If you need a refresher on the GitHub flow, check out the Introduction to GitHub course.

⌨️ Activity: Turn on GitHub Pages

The first step to publishing your blog to the web is to enable GitHub Pages on this repository 📖. When you enable GitHub Pages on a repository, GitHub takes the content that's on the master branch and publishes a website based on its contents.

  1. Under your repository name, click Settings
  2. In the "GitHub Pages" section, use the Select source drop-down menu to select the master branch as your GitHub Pages publishing source.
  3. Click Save

After GitHub Pages is enabled, we'll be ready to create some content.

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.

Step 2: Customize your homepage

Great job! Now that GitHub Pages is enabled, you can view your website here: https://CongAn.github.io/github-pages-with-jekyll

NOTE: You'll be updating your GitHub Pages site in the upcoming steps. To make things easier to view, I recommend that you open this link in another tab or window for quick access to view your changes.

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, or click this link here.
  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