---
layout: post
title: Jekyll 博客工具升级 3.0 版 修复本地预览功能
categories: [blog ]
tags: [Tech, ]
description: 一次手贱更新版本带来的后续问题及解决...
---




前一天深夜手贱 update 了 rubygems，还一并更新了 gems 的所有安装包，与时俱进麽。结果，昨天想用 Jekyll 博客本地预览服务时发现 Jekyll 升级到了 3.0.1 版本，自动生成本地博客的服务很果断地出问题了...


运行 ```$ jekyll serve``` 出现报错：

最开始遇到的提示是：

> Deprecation: You appear to have pagination turned on, but you haven't included the `jekyll-paginate` gem. Ensure you have `gems: [jekyll-paginate]` in your configuration file.

安装 Jekyll-paginate 插件

```
$ sudo gem install jekyll-paginate
```

确认是否已经包含在已安装的 gem 插件列表中：

```
$ gem list
```

然后，将 `gems: [jekyll-paginate]` 这一段设定添加到自己博客仓库主目录下的 _config.yml 文件中。

嗯...这个文件就算解决了。但是！升级这么折腾的事岂会让我这么轻松愉快就跑起 Jekyll 博客来呢……

再次运行 ```$ jekyll serve``` 遇到一个新的问题：

> Since v3.0, permalinks for pages in subfolders must be relative to the site source directory, not the parent directory. Check http://jekyllrb.com/docs/upgrading/ for more info.
 
解决方案：

删除 _config.yml 文件下的 `relative_permalinks: true` 一项。  

再次运行服务，恢复正常啦。

![](http://dreamofbook.qiniudn.com/Blog.Jekyll.Run.The.Serve.png)
Write a new post about jekyll serve problems
Write a new post about jekyll serve problems
