There are different choices to host a static website on github.
There is one of them that in my point of view is one of the easiest ways.
First we need to create a static website that will be hosted on github pages,Hugo(https://gohugo.io/) is a static site generator that allows you to create a website with little to no code and we are going to use it to build the static web site.
For creating static websites with Hugo:
- Install Hugo on local
- Create a github repository($githubrepositoryname) where you are going to upload the info for your github page (where gonna be hosted the blog information)
mkdir $githubblogrepositoryname
cd $githubblogrepositoryname
hugo new site .
cd $githubblogrepositoryname
git init
# git remote add origin https://github.com/ldipotetjob/nomorethanonehundredandsixtysix.git
git remote add origin https://github.com/$repository.username/$githubblogrepositoryname.git
git pull origin master
echo "public/" >> .gitignore
git add .
git commit -m "initial commit"
git push origin master
# git submodule add https://github.com/Track3/hermit.git themes/hermit
git submodule add $git_repository-of-HugoTheme themes/hermit
# getting rid of git submodule(.gitmodules) untracked status
# add => ignore = dirty to .gitmodules file
hugo server -D
####
# ........
# Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
####
Create the github page.
Remenber it's format:
http(s)://<username>.github.io
or http(s)://<organization>.github.io
#clone the repo that contain github page
git clone https://github.com/<username>/<username>.github.io.git
# move to the directory($githubblogrepositoryname) where your blog info is located
cd $githubblogrepositoryname
- The hugo static site will need a binding to a github url page:
In theconfig.toml file the key baseURL must have the github url page
baseURL =http(s)://<username>.github.io
- Check that you are on $githubblogrepositoryname and then launch: hugo -d ./<username>.github.io/
- Move to the directory .github.io (directory where have been cloned the github page:
http(s)://<username>.github.io
) - Commit and upload the changes to remote and have fun 👍