You can do this entire tutorial from your browser!

Steps

  1. Register for a GitHub account.

    • You will need an email account, I recommend a gmail account with the same name as your Github account alias.
    • pick a name that you want to use as your alias forever.
    • you will by typing this alias a lot!
    • I recommend an alias that
      • is made of only lowercase a-z characters
      • is less than 10 characters

  2. (optional) Create a Logo for your alias

    • You can change this whenever but it acts as your symbol
    • (I've never changed mine)

  3. Create a repository with ALIAS.github.io where ALIAS is your github alias.

    • Click Create repository
    • set the repository name to ALIAS.github.io where ALIAS is your github alias.
    • Enter a description of my website
    • Check Add a README file

  4. There are two main options for your website

    • Website using HTML
    • Blog using Jekyll

  5. For your first site use HTML to check that everything is working.

    • Setting up Jekyll is difficult and requires installing things on your desktop, you can always switch to Jekyll later.

  6. We are going to create the main page for the site called index.html

  7. On the open repository in your browser click Add file -> Create new file

  8. Name the file docs/index.html

  9. Copy and paste the following into the file.

    <!DOCTYPE html>
<html lang='en'>

<head>
<!-- Metadata goes here -->
<meta charset='UTF-8' />
<title>Hello World!</title>
</head>

<body>
<!-- Content goes here -->
<h1>Hello World!</h1>
</body>

</html>

  10. click Commit new file

  11. Now we will to set up the repository to publish the site

  12. Click Settings -> Pages

  13. Set source to Deploy from branch

  14. Set branch to main /docs

  15. Click Visit site to visit your new website!

Further Reading

About GitHub Pages

Github Pages Terms of Use