Categories
Tech

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.

Categories
Tech

Expressing Yourself on the Web: Neocities

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

In this week-long series on expressing yourself on the web, I want to talk about five separate services that allow you a platform you can use to express yourself on the web. Today, we’ll be talking about Neocities, a host of static HTML pages and popular with sites that use old-web tech.

What can you build on Neocities?

Honestly, if everything your website can do is done in the browser with no server processing, Neocities is okay for you. Though, you probably would need some knowledge of HTML and CSS. You can find free learning guides on Sadgrl’s website and Codeacademy. However, if you want a guided learning path, I’d recommend this track from Treehouse.

Put simply, if you used something like Geocities back in the day (think 1990s to early 2000s), this is the service for you.

If running WordPress is crossing your mind, Neocities is probably not for you. If you plan to use this to build a blog, don’t. Honestly, this service isn’t great for that. Also, any preprocessing is going to be out the door, so things like Markdown are not going to be interpreted into HTML for you.

Having said that, though, the wide variety of sites that exists on Neocities is something to behold. As someone who actually used the old web, I can’t help but feel a bit nostalgic. Seeing all these websites use old web tech makes me irrationally happy. I, for one, would love to see more people building websites using this tech.

What would I recommend this service for?

Honestly, pages that you don’t intend to update often. Also, if you’re not uncomfortable with a text editor like Nova or VS Code. Alternatively, you can use some sort of WYSIWYG HTML generator.

On the one hand, it is a free service. However, on the other hand, you’ll have to work to publish anything here. So, this service is perfect for smaller websites where you don’t mind updating things manually.