INFX 512 Spring 2018 Coursework

Publishing to GitHub pages

You can configure GitHub Pages to publish your site's source files from master, gh-pages, or a /docs folder on your master branch for Project Pages and other Pages sites that meet certain criteria.

If your site is a User or Organization Page that has a repository named <username>.github.io or <orgname>.github.io, you cannot publish your site's source files from different locations. User and Organization Pages that have this type of repository name are only published from the master branch.

Create a branch to publish

After you've created either a master or gh-pages branch, you can set one as your publishing source so that your site will be published.

If you fork or upload your site repository with only a master or gh-pages branch, your site's source setting will automatically be enabled for that branch.

Create an index.html page

Animation of creating an index HTML page

Push the master branch to GitHub

Animation of pushing code to GitHub

Change setting in GitHub

Animation of changing settings in GitHub

View the page in a browser

https://[orgname].github.io/[reponame]

Screenshot of website in in a browser

Source