Setting Up
↳Part of: A Non-Programmers Guide To GitHub Sites

  26 Mar 2017

For this project, I shall be explaining how I used a template and modified this to make this blog. Whilst not all templates are made in the same way, they do bear a lot of similarities and I am fairly confident that one can easily apply the lessons learned here to other projects.

I have chosen the template Herring Cove, by @Arnp. It is a rather good looking and simple template that is easy to modify.

Forking the Project

What is Forking?

A fork is a personal copy of another user’s repository (basically their project) that lives on your account. Forks allow you to freely make changes to a project without affecting the original.
From the GitHub Glossary

For our purposes, we shall be creating a personal copy of the Herring-Cove template, that we shall customize to suit our needs.

To Fork our Project, all we need to do is simply press the Fork button on the GitHub Page, by @Arnp


You will finally need to change the settings of your project, to allow your GitHub page to be live.

To do this you need to open your project’s repository, which can be done by navigating to the Your repositories section of the GitHub homepage.

Your Repos

In the bar you need to select Settings.

Select Settings

And change the Source setting from the GitHub Pages section to Master.

Github Settings

Setting up GitKraken

While using a Git Client is not strictly necessary, it does provide a certain level of convenience. Of course you can use the GitHub web interface or the command line Git service, but that is not necessarily required when there is a simple client that can do this for you.

I use GitKraken, as it is a cross-platform client, that has a simple and intuitive interface. You can download GitKraken here.

Upon installation, GitKraken will prompt you to link your account to GitHub.

Once you have linked your account, you can clone your fork of the Herring-Cove to your computer. By cloning, you are essentially creating a local copy of the project.

You do this by either:

  • File-->Clone Repo
  • CTRL + N

In the popup, you can first of all choose from where you shall clone your fork. In our case, this shall be from (Not Enterprise).

Following that, you can select the folder to which you shall clone the fork. Any folder shall do for this step, but it should be placed in a sensible place. Select the herring-cove repository to clone and finally hit the Clone the Repo! button to begin the cloning progress.

Clone Menu

Once the project is successfully cloned, you can now open the project using the Open Menu (File-->Open Repo or simply CTRL+O) and selecting the project from the file menu.

Setting up Atom

The reason why I prefer using Atom is that it supports projects. This makes is superior to Notepad++ in my opinion, as you can for instance perform Find and Replace operations on multiple files. A further benefit is that it contains a Markdown Preview, which shall be useful when writing your blog posts.

To configure Atom for your project, you simply need to add it as a project folder. This can be done either via File-->Add Project Folder or the shortcut CTRL+SHIFT+A.

And that’s it!

You finished configuring the project.

You can now view your site at https://<Your User Name>

In the event you have renamed your repository to something else, replace herring-cove with the repositories name

Creative Commons LicenseThe content of this site's posts are licensed under a Creative Commons Attribution-NonCommercial 4.0 International License. Read More
comments powered by Disqus