How to Setup a Free GitHub Page with Jekyll | Hacker Noon

June 15th 2020

Author profile picture

This is a quick tutorial on how to create a GitHub page and learn some tricks on how to perfect it. I will be going through the steps of how I created my GitHub page.

There will be a time you would want to explore how to create a page for your project, blog etc. GitHub provides an easy setup solution for anyone who would to like get the website sorted and hosted for free. On top of that, the smooth integration with its own repository system enables developers to easily modify and update changes on the website.

There are endless ways to setup a GitHub page and I would like to show you one of them. I have chosen Jekyll as a static site generator. Jekyll is simple to use with your favourite mark-up language and it uses layouts to create a static website. However it is totally up to you regarding which site generator you would like to use.

Let’s get started

Step 1 : Install Ruby

Open your command prompt ( terminal for those who are mac users )

First thing you need to do is install a full Ruby. Jekyll is a Ruby program so you need to install Ruby on your machine to begin with. Head over to the install guide and follow the instructions for your operating system.

If you would like to check the version number or whether it is properly installed, then type

Step 2 : Install Jekyll and bundler gems.

You can carry on using command prompt but I like to switch to Visual Studio Code and “File>Open Folder”  

Then choose the directory where you want your Github page to be stored. After that, open the terminal in VSCode. As you can see in this example my directory is 



Now install Jekyll with the following command;

gem install jekyll bundler

Step 3 : Create a new Jekyll site

Create a new Jekyll site at ./myblog

jekyll new yourblogname

Note: Now I need to mention something about the repository page name criteria. It cannot be different from the owner user name. Otherwise it won’t work. The criteria is

Change into your new directory.

For example;

PS C:Usersserda> cd

You need Bundler to resolve these dependency conflicts. Use Bundler to install all the needed Ruby gems

bundle update

Build the site and make it available on a local server.

bundle exec jekyll serve

In fact there are two commands,

  • jekyll build – Builds the site and outputs a static site to a directory called _site.
  • jekyll serve – Does the same thing except it rebuilds any time you make a change and runs at a local web server.

Browse to http://localhost:4000 ( In this example it is ) Your website should look like below

Step 4 : Go live on GitHub

Jump back to GitHub and create a new repository As I mentioned before the repository name cannot be different from the owner’s user name. Otherwise it doesn’t work.

Note: If you custom domain, you can place it in the settings section you can see above.

Now go to your repository. You can either use GitHub desktop application or simply upload all the files in the directory directly into the new repository. 

I am hoping you did not have any problem so far. Now your Github page should be live.

…and you’re done!

Congratulation! Your page is live!

If desired to use a different template, you can find many free templates online. Don’t forget to check github.

Thank you for following my tutorial. I hope you found it useful for you.


The Noonification banner

Subscribe to get your daily round-up of top tech stories!

read original article here