quickstart.md

title	Quickstart for GitHub Pages
intro	You can use {% data variables.product.prodname_pages %} to showcase some open source projects, host a blog, or even share your résumé. This guide will help get you started on creating your next website.
allowTitleToDifferFromFilename	true
versions	fpt ghes ghec * * *
type	quick_start
topics	Pages
shortTitle	Quickstart
product	{% data reusables.gated-features.pages %}

Introduction

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

Creating your website

{% data reusables.repositories.create_new %}

1. Enter username.github.io as the repository name. Replace username with your {% data variables.product.prodname_dotcom %} username. For example, if your username is octocat, the repository name should be octocat.github.io. {% data reusables.repositories.choose-repo-visibility %} {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %}
2. Under "Build and deployment", under "Source", select Deploy from a branch.
3. Under "Build and deployment", under "Branch", use the branch dropdown menu and select a publishing source.
4. Optionally, open the README.md file of your repository. The README.md file is where you will write the content for your site. You can edit the file or keep the default content for now.
5. Visit username.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 {% data variables.product.github %}.

Changing the title and description

By default, the title of your site is username.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 the Code tab of your repository.

2. In the "Add File" drop-down menu, click "+ Create new file"

3. Name your file "_config.yml"

4. Add the following lines to your file and tweak to your liking to adjust the theme, title, and description. For example:

   theme: jekyll-theme-minimal
   title: Octocat's homepage
   description: Bookmark this to keep an eye on my project updates!

5. When you are finished editing the file, click Commit changes.

Next Steps

You've successfully created, personalized, and published your first {% data variables.product.prodname_pages %} website but there's so much more to explore! Here are some helpful resources for taking your next steps with {% data variables.product.prodname_pages %}:

• AUTOTITLE: This guide explains how to add additional pages to your site. {% ifversion fpt or ghec %}* AUTOTITLE: You can host your site on {% data variables.product.prodname_dotcom %}'s github.io domain or your own custom domain.{% endif %}