Guide — GitHub Pages — Beginner

Prakash M.
2 min readFeb 29, 2020

Valid: This post is valid as of March 2020.

Scope: This article only covers the GitHub pages created through github.io repository. This article doesn’t contain instructions for Custom Domain GitHub Pages or GitHub Pages with Jekyll.

1. GitHub Pages

GitHub pages works straight away when you place a valid “index.html” file in a repository which is named as that of the username along with “github.io” suffix. i.e. <username>.github.io

2. Link other repositories to GitHub Pages

GitHub has also allowed other repositories belonging to that User (username) to be part of the main GitHub page (through sub-routes) i.e. <username>.github.io/<other-repositories>

This option can be found under the “Settings > GitHub Pages” of any repository. Select the Source branch and it will automatically be published as a sub-route of the main GitHub Page.

Do let me know if my article needs correction / improvement. TIA.

--

--