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:
- Create a Gemfile and add
gem 'jekyll-paginate'. Then run
- 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.