GitHub Essentials - Second Edition

Creating a project page

Project pages are somewhat different to user/org pages; the source files of your website can reside in one of the three following locations: the gh-pages branch, the  master branch, or a docs directory of the master branch. You can choose which one you want to use by selecting it under your repository's Settings under GitHub Pages.

For project pages, if there is a branch named gh-pages in the repository, then its HTML content is automatically served by GitHub. The project page will ultimately be accessible via https://<username>.github.io/<repositoryname>.

Here, I will create a gh-pages branch in the github-essentials repository, make a new index.html file, and commit and push to the gh-pages branch:

git checkout -b ...