Expressing Yourself On the Web: Jekyll & Github Pages

This entry is part 2 of 2 in the series Expressing Yourself on the Web

Yesterday, in my series about expressing yourself on the web, I talked about Neocities and the expressing yourself in an old web way. Today, I’m going to write about using Jekyll & Github Pages to build a website.

What is Github Pages?

Github Pages is a service run by Github that allows users to launch web pages for free. It was launched to help open source projects have a place to communicate information about their projects.

Github has limited preprocessing. Namely, processing Markdown and Jekyll projects. Hence why I’m recommending Jekyll to go along with Github Pages.

What is Jekyll?

A screenshot of the homepage of Jekyll.

Jekyll is a ruby-based system to facilitate pre-processing static content written in Markdown. It allows you to use a command-line interface to compile a site into static content. Alternatively, you can use Github Pages to avoid the command-line interface and have Github compile the site for you.

If you have a Mac, you can install Jekyll pretty easily using the Terminal. And I’ll explain how.

What you’ll need to know to use Jekyll & GitHub Pages

Honestly, you’ll need the HTML & CSS knowledge I mentioned in the Neocities review, but with this, you’ll also need to understand concepts related to Git and some Ruby knowledge wouldn’t hurt. So, if Neocities seemed a bit challenging for you, I wouldn’t recommend this approach either.

How to install Jekyll on Mac and set up a website

First, go into the Applications folder. Then, go into the Utilities folder. There should be an app labelled “Terminal”. Open it. You’ll need to copy and paste the following command into your terminal:

gem install bundler jekyll

Then, once that command has finished running, you’ll need to navigate to where you want to install the Jekyll site. For example, if you want to put the folder in your Documents folder, you’ll need to run this command.

cd ~/Documents

Then, run the following command, changing the text in bold into the name you want to choose for a site. No, you can’t use spaces in this version of the name so don’t ask.

jekyll new my-awesome-site

There you go! You’ll have a new Jekyll site on your computer. All you’ll have to do is commit it to GitHub with every change. You could do so through the command line, but you can also use the GitHub Desktop app.

If you found this a bit too involved, the next option will probably be more your speed. If you found it too easy, then Thursday’s entry would probably make you happy.

Series Navigation<< Expressing Yourself on the Web: Neocities

Leave a Reply

Your email address will not be published. Required fields are marked *