Enable Github Pages
Uploaded by
Azizul HuqEnable Github Pages
Uploaded by
Azizul HuqGitHub Pages
A quick reference guide to complete the steps in the course.
https://lab.github.com/courses/github-pages/
1. Enable Github Pages
1.1. Click on the S
ettings tab for this repository
1.2. Scroll down to the GitHub pages section
1.3. Select the N
one dropdown
1.4. Click on M
aster b
ranch
1.5. Click S
ave
2. Customize your homepage
2.1. On the Code tab, click the i ndex.md file
2.2. Click the pencil (✏) icon to enter edit mode and add a few lines of content.
Remember, you can use Markdown
2.3. Scroll to the bottom and select the option to “Create a new branch for this
commit and start a pull request”
2.4. Select P ropose file change
2.5. Write some text in the “Leave a comment” field of the pull request
2.6. Click C
reate pull request
3. Merge you pull request
3.1. Click M
erge pull request below
3.2. Click C onfirm merge
3.3. Go ahead and delete your branch in this pull request
4. Add a theme
4.1. Return to the Settings tab for this repository
4.2. Scroll down to the GitHub Pages section
4.3. Click C
hoose a theme
4.4. Decide which theme you would like to use, and click Select theme
5. Customize site details
5.1. On the Code tab, click the _ config.yml file
5.2. Click the pencil (✏) icon to enter edit mode and change the line specifying
theme to theme: m inima
1
5.3. Change the other configuration variables such as t itle: , a
uthor: , and
description: t o customize your site
5.4. Scroll to the bottom and select the option to “Create a new branch for this
commit and start a pull request”
5.5. Click P
ropose file change
5.6. Add some content in the “Leave a comment” field
5.7. Click C reate pull request.
6. Create a blog post
6.1. On the Code tab, select your branch
6.2. Click C
reate new file
6.3. Name the file _ posts/YYYY-MM-DD-title.md, but replace the Y YYY-MM-DD with
today’s date, and title with the title you’d like to use for your first blog post
6.4. Type a quick draft of whatever you’d like to blog about. Remember, you can
always edit it later
6.5. Scroll to the bottom and commit your changes to your branch.
7. Add blog post metadata
7.1. Click the F
iles Changed tab in this pull request
7.2. Click on the pencil (✏) i con on the right side of the screen
7.3. Add the following content to the top of your blog post:
---
title: "YOUR-TITLE"
date: YYYY-MM-DD
---
7.4. Replace YOUR-TITLE with a great title for your blog post
7.5. Replace YYYY-MM-DD with today’s date
7.6. Commit your changes to your branch
8. Merge your first post
8.1. If satisfied with your post, click Merge pull request
8.2. Click C onfirm merge
8.3. Click D elete branch
