Upgrading to Jekyll 3

On October 26, 2015, Jekyll 3.0 was released. You can check out the blog post athttp://jekyllrb.com/news/2015/10/26/jekyll-3-0-released/. I decided to try it out but I ran into a few issues. One big one that many may face is the built-in pagination feature. In version 3, it is now deprecated. You can still use it but you must install it separately. You can do this in two ways:

  1. Create a Gemfile and add gem 'jekyll-paginate'. Then run bundle.
  2. Just install it with gem install jekyll-paginate.

If you create a Gemfile, make sure you add it to the exclude array in your config file. Also, add Gemfile.lock.

I also ran into an error with kramdown and jekyll-watch. I solved it the same way I did jekyll-paginate.

In one of my other websites built with Jekyll 2.5.3, I ran into issues with plugins. Be prepared for that as well, many will be broken. I’d like to get that fixed because it’s a site with over 300 posts. I want to see if Jekyll 3 has improved the speed of compiling.

If you are using permalink, make sure you have a trailing /. I was getting 404 errors on newly published files before I added the / in my permalink values. I’m not sure if it’s related to caching or just a weird bug I ran in to.

Finally, the last thing I noticed with version 3 is it includes the year of post date as part of the categories array. I’m not sure if that’s intensional, a bug, or I’m using old code.

Good luck with version 3. I’m glad for the new version but it has its headaches. I just have to be more patient and learn new things.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s