First, you’ll need to create a github account. If you won’t be using a custom domain (You can add one later), make sure you name the account what you want your website to be. The domain will be {{ account-name.github.io }}

Once you have an account, the first thing you will do is generate a new ssh key and add it to github. This will give you passwordless access to your github account from your desktop. From my Fedora Linux machine, I will run:
ssh-keygen -t ed25519 -C "exampleemail@email.com"

When it asks for the name of the key, give it a unique name to use for this account. I just picked the gitup account name to make it easy to identify:
id_ed25519_example

Then, grab your public key from ~/.ssh/id_ed25519_example.pub and add it in github under settings > SSH and GPG Keys > New SSH Key

Next, go to your github homepage and select “Create repository”. The repository name needs to match your github account name from earlier. It also must have public visibility:

From your desktop, create a directory with {{ reponame.github.io }}. You must use this format for this to work: mkdir everythingelsexyz.github.io && cd everythingelsexyz.github.io

Follow the instructions on github for “…or create a new repository on the command line”.

echo "# everythingelsexyz.github.io" >> README.md
git init
git add README.md
git commit -m "first commit"
git branch -M main
git https://github.com/everythingelsexyz/everythingelsexyz.github.io.git
git push -u origin main

Then add credentials:

git config user.name "everythingelsexyz"
git config user.email "everythingelsedt@gmail.com"

If you have multiple github accounts, you’ll have to create aliases for each one in the ~/.ssh/config file:

Host linuxreader.github.com
    HostName github.com
    IdentityFile ~/.ssh/id_ed25519

Host everythingelsexyz.github.com
    HostName github.com
    IdentityFile ~/.ssh/id_ed25519_everythingelsexyz

Then add your private keys to the ssh agent:

ssh-add ~/.ssh/id_ed25519
ssh-add ~/.ssh/id_ed25519_everythingelsexyz

Then add the username and email settings while in the new project directory:

everythingelsexyz.github.io on  main 
❯ git config user.name "everythingelsexyz"

everythingelsexyz.github.io on  main 
❯ git config user.email "example@email.com"

Then you will need cd to each repo and add an alias:

linuxreader.github.io on  main [⇡] via 🐹 via  
❯ git remote set-url origin git@linuxreader.github.com:linuxreader/linuxreader.git

everythingelsexyz.github.io on  main 
git remote set-url origin git@everythingelsexyz.github.com:everythingelsexyz/everythingelsexyz.git

Load the keys into the agent:

ssh-add ~/.ssh/id_ed25519
ssh-add ~/.ssh/id_ed25519_everythingelsexyz

Adding a Hugo Theme to your Github Repository

#

Host

Go through quick setup here: https://pages.github.com/

Hugo Setup: https://gohugo.io/hosting-and-deployment/hosting-on-github/

Here’s how to set up a free website using Github pages and Hugo. You can add a custom domain name using Cloudflare for about $10 per year.

The general steps include:

1. Create a Github repository for your site.
2. Change your pages settings.
3. Build the repo into a Hugo site.
4. Add DNS records for a custom domain.