Introduction

In this guide, you'll create a user site at<username>.github.io.

Creating your website

1. In the upper-right corner of any page, select, then clickNew repository.

   

2. Enterusername.github.io as the repository name. Replaceusername with your GitHub username. For example, if your username isoctocat, the repository name should beoctocat.github.io.

   

3. Choose a repository visibility. For more information, seeAbout repositories.

4. ToggleAdd README toOn.

5. ClickCreate repository.

6. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then clickSettings.

   

7. In the "Code and automation" section of the sidebar, click Pages.

8. Under "Build and deployment", under "Source", selectDeploy from a branch.

9. Under "Build and deployment", under "Branch", use the branch dropdown menu and select a publishing source.

   

10. Optionally, open theREADME.md file of your repository. TheREADME.md file is where you will write the content for your site. You can edit the file or keep the default content for now.

11. Visitusername.github.io to view your new website. Note that it can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub.

Changing the title and description

By default, the title of your site isusername.github.io. You can change the title by editing the_config.yml file in your repository. You can also add a description for your site.

1. Click theCode tab of your repository.

2. In the file list, click_config.yml to open the file.

3. Click to edit the file.

4. The_config.yml file already contains a line that specifies the theme for your site. Add a new line withtitle: followed by the title you want. Add a new line withdescription: followed by the description you want. For example:

   theme:jekyll-theme-minimaltitle:Octocat'shomepagedescription:Bookmarkthistokeepaneyeonmyprojectupdates!

5. When you are finished editing the file, clickCommit changes.

Next Steps

You've successfully created, personalized, and published your first GitHub Pages website but there's so much more to explore! Here are some helpful resources for taking your next steps with GitHub Pages:

• Adding content to your GitHub Pages site using Jekyll: This guide explains how to add additional pages to your site.
• Configuring a custom domain for your GitHub Pages site: You can host your site on GitHub'sgithub.io domain or your own custom domain.