TODO

Installation

Ubuntu repo as of this date uses less than Ruby2. So we will have to retrieve from Ruby website the latest and setup our operation system environment.

Install Ruby higher than 2.1 from https://www.ruby-lang.org/en/downloads/

Using 2.4.1 for this tutorial.

cd ~
wget https://cache.ruby-lang.org/pub/ruby/2.4/ruby-2.4.1.tar.gz
tar -xzvf ruby-2.4.1.tar.gz
rm ruby-2.4.1.tar.gz

Now to configure default settings and install.

cd ~/ruby-2.4.1
./configure
sudo make install

Hopefully all is well at this point. If using a different Xubuntu or Ubuntu version, you may have to install a bajillion dependencies. Good luck on your internet search results!

The ruby source version will be installed in /usr/local/lib/ruby by default

Time to install Jekyll and dependencies. Installing Jekyll 3.5.0 as of this writing.

sudo gem install jekyll bundler minima jekyll-feed

Running Jekyll

To test out the default jekyll website by creating one…

mkdir my_jekyll_website
cd my_jekyll_website
jekyll new .

If error messages appear, install the missing gems it requires until you finally see that the new jekyll site is installed.

To see our default Jekyll website

jekyll s

Open up a web browser and go to localhost:4000

»


Hosting a Website for Cheap Part 1

Why Jekyll

Building and hosting websites have come a long way over the years. There are so many options, that it can be a little daunting starting out. I am by far not a front-end web developer. And if you are like me, you may be seeking an easy solution like a hosted platform that takes care of much of the labor such as Medium or Word Press for hosting a blog or simple website.

I’m going to provide a solution for those seeking to build a simple static website that can be used as a blog, portfolio, or what have you using a variety of tools. In a series of posts, I’m going to outline how I put together this website and how I host my email for ~$0.53 per month.

I use to pay $10 per month for DNS and virtual private server hosting. Let’s actually break down what I get now versus $10 per month paying before. For $0.53 per month, I have a scalable website that can grow at demand with zero intervention or labor on my behalf. Free https support enabled on this website where I do not have to renew any certificates for. I have a free custom domain email address where I can generously send and receive way more emails than I will ever need. Now I could cut the costs to $0, but that would take away any custom domain names I could assign to website and email hosting. A very small price to pay.

Interested? Let’s dive into the real meat. We are going to start from the ground up on how to get Jekyll going on our local machine.

Linux Installation

I will be using Xubuntu-16.10 for now on. Open up a terminal and install the following software packages with:

sudo apt-get install ruby2.3 ruby2.3-dev
sudo gem install jekyll bundler
jekyll new my-blog

What we did thus far is install Ruby 2.3(Ruby2.4 is the latest of this writing but is not supported in the latest Ubuntu Repos as of yet). We also installed the development header files for ruby which are required for installing the gems jekyll and bundler. Lastly, we created a default layout of “my-blog”.

Serving up our Jekyll web site

Now it’s time to spin up what we have thus far.

jekyll serve

This in serve creates a local web server and creates our static html files (that are placed in _site folder)that can be viewed in our web browser at localhost:4000 by default.

If you are wondering how do I navigate and figure out what does what, I would like to point you to https://jekyllrb.com/docs/structure/.

Prettifying and Adding Content

The current default layout for our Jekyll site is bland. A great way to overhaul our look is to browse at http://jekyllthemes.org/ where there are a number of free layouts that one can drag and drop into the _layouts folder.

Assuming the default layout, let’s put together a post. The easiest way is to examine our only example in the _posts folder. Notice how the file name is dated as that is important for making more posts.

If you are not familiar with Markdown, I would recommend looking at https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet.

Try it for yourself and create a post in that directory. See the results in the web browser by refreshing the home page. Any errors will be displayed in the terminal.

Conclusion of Part 1

Thus far, we have a simple Jekyll web site but we can’t actually access it from the web. In the next part, we will take a look at deploying it to Github Pages. Our site will be managed and hosting on Github not a private web server like Amazon S3, Digital Ocean, etc. Any changes or content we add, will be through Git.

»