Skip to content

The code hosted here shouldn't be more than one hundred and sixty six line of code. Comments don't count

Notifications You must be signed in to change notification settings

ldipotetjob/nomorethanonehundredandsixtysix

Repository files navigation

Hosting your static website generated by HUGO on github page http(s)://<username>.github.io

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:

  1. Install Hugo on local
  2. 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 .

Creating and configuring github repo to store the site previously created

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 

Now let's check if everything went well. Deploy in local

hugo server -D 
####
# ........
# Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
####

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

How our Hugo static website can be deployed on github page

  1. 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
  2. Check that you are on $githubblogrepositoryname and then launch: hugo -d ./<username>.github.io/
  3. Move to the directory .github.io (directory where have been cloned the github page: http(s)://<username>.github.io)
  4. Commit and upload the changes to remote and have fun 👍

About

The code hosted here shouldn't be more than one hundred and sixty six line of code. Comments don't count

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published