Welcome
github-learning-lab opened 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 that 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?
For this course, 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: Generate a GitHub Pages site
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 main branch and publishes a website based on its contents.
- Under your repository name, click Settings.
- In the "GitHub Pages" section, in the Source drop-down, select main branch.
After GitHub Pages is enabled and the site is started, we'll be ready to create some more content.
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://nanometrenat.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
- Navigate to the Code tab of this repository, and browse to the
index.md
file, or click this link here - In the upper right corner, click the icon to edit the
index.md
file - Type the content you want on your homepage. You can also modify
title:
or just ignore it for now. We'll discuss it later in this course. - Scroll to the bottom, type a commit message, and click Create a new branch for this commit and start a pull request
- Open a pull request
Once you have created your pull request, I will move over there to discuss next steps.