Andrew Gable

ResumeBlogPhotos

Move to Jekyll

03 August, 2014

I decided after a few issues with the blogging CMS Dropplets that it was time for a change. I decided to move onto a different blogging system, Jekyll.

Jekyll is supposed to be a

"Simple, blog-aware, static sites"

A simple, blog-aware, static site is exactly what I had before with Dropplets, but checking out their GitHub Repo I was very impressed. There had been commits today! I was very excited about a project that was current and a little bit more widely used.

I first had to install Jekyll which they say on their Quick Start to follow these commands:

gem install jekyll
jekyll new myblog
cd myblog
jekyll serve

But that is assuming that you have the prerequisites installed:

-Ruby -RubyGems -Linux, Unix, or Mac OS X -NodeJS, or another JavaScript run time (for CoffeeScript support).

###1. Ruby

Installing RVM: Ruby Version Manager is highly recommended. You can install RVM and the latest stable version of Ruby by typing in:

curl -L https://get.rvm.io | bash -s stable --ruby

Also it is recommended to place this in your ~/.profile file:

[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"  # This loads RVM into a shell session.

###2. RubyGems

RubyGems should be installed but just to make sure everything is up to date run this command:

gem update --system    

If not, check out the RubyGems Site.

###3. Mac OS X

Version 10.9.4 installed!

###4. NodeJS

I went ahead and installed NodeJS onto my laptop. I downloaded the easy installer and was able to install it with no pain.

Now I was back in business! I ran the commands:

gem install jekyll
jekyll new myblog
cd myblog
jekyll serve

First Jekyll

And ended up getting a working site on http://0.0.0.0:4000/

Now I was on the look out for a simple, flat and easy blog looking theme. With some quick Googling I found a theme that I liked called Lanyon. Lanyon has a great design and user experience for a simple blog. Also, I loved the reference from the book Dr. Jekyll and Mr. Hyde.

First Lanyon

A content-first, sliding sidebar theme for Jekyll.

I fell in love with the theme and was very excited that one of my favorite developers Mark Otto developed the theme. Mark also was one of the main developers for the beautiful Bootstrap Framework that I use on my main homepage.

I started hacking on the cloned repository and loved the code style, the documentation, and the ease to get things done quickly. I had to manually change some of the files from the old Dropplets format, to the the new Jekyll format. They still shared the Markdown file format, just had different naming conventions and file structure.

Building and deploying to a local environment went extremely quick with the command:

jekyll serve --watch

Which was ran from the inside of the of the Lanyon directory. The --watch flag which is "Same as jekyll serve, but watch for changes and regenerate automatically". So I would just have to do a quick refresh on http://0.0.0.0:4000/ and all my changes would appear in my browser.

After I was done developing the blog, I had to figure out how to deploy the static code that was generated by Jekyll, reading the deployment documentation that it could not be easier.

Copy the generated _site folder to the root folder of your hosting account.

Super easy! And even easier with the Sublime SFTP Plugin. All I have to do is right click on my _site folder and sync it up with my web server after a quick jekyll build and my blog is updated.

I could not be happier with the theme Lanyon and Jekyll project. Look for more blog posts of my experience with Jekyll and continue to check back to see my tweaks of the new look.

© 2024 Andrew Gable