jekyll在mac下安装和运行指南-京东云开发者社区

###  安装命令
`jekyll`主要是用`ruby`语言写的，所以是用`Gem`服务托管，需要`Gem`来安装。
```bash
gem install jekyll bundler
```
补充说明：jekyll的版本必须是 3.4.0

[http://jekyllcn.com/docs/installation/](http://jekyllcn.com/docs/installation/)

#### 问题一 ruby版本低
`Ruby` 需要大于`2.4.0`版本的，小于`2.4.0`的需要更新`Ruby`。解决方案如下：

##### 1、安装 RVM

`rvm`为`Ruby Version Manager`，`Ruby`版本管理器，包括`Ruby`的版本管理和`Gem`库管理。
```bash
curl -L get.rvm.io | bash -s stable 
```
等待一段时间后就可以成功安装好`rvm`。
再修改环境变量。
```bash
source ~/.bashrc  
source ~/.bash_profile  
```
测试是否安装正常
```bash
rvm -v  
```
 ![image.png](https://img30.360buyimg.com/pop/jfs/t1/100480/34/13135/198396/5e5726b6E06367c27/adc86ddde447a5f5.png)

##### 2、用rvm升级ruby
```bash
rvm list known  
```
列出已知的ruby版本
![image.png](https://img30.360buyimg.com/pop/jfs/t1/109710/31/7110/45548/5e5726c3Eaba37988/7ede0203d77df393.png)

##### 3、升级ruby
```bash
rvm install 2.4.6
```
#### 问题二 遇到了包安装错误
 ![image.png](https://img30.360buyimg.com/pop/jfs/t1/84719/22/13267/77990/5e5726c7E1d25108b/176154d8737bce86.png)

解决方案：
用`brew`去安装所有的`package`
```bash
brew install autoconf automake libtool apple-gcc42 libyaml libxslt libksba openssl
```
![image.png](https://img12.360buyimg.com/imagetools/jfs/t1/119200/18/17622/174140/5f5b1260E531d56e3/b8c8b891c194267d.png)

解决方案：
Homebrew国内如何自动安装（国内地址）:

[https://zhuanlan.zhihu.com/p/111014448](https://zhuanlan.zhihu.com/p/111014448)

安装可能存在的其他报错解决方法：（可用方法二）

[https://blog.csdn.net/qq_43531694/article/details/106862753
](https://blog.csdn.net/qq_43531694/article/details/106862753
)

#### 问题三 未安装 jekyll-paginate
```bash
gem install jekyll-paginate
```
###  生成博客
```bash
jekyll new my-awesome-site
cd my-awesome-site
bundle install
jekyll serve
```
![image.png](https://img30.360buyimg.com/pop/jfs/t1/96738/11/13273/58524/5e5726caE99d387c9/0bc53c9397e03222.png)

打开浏览器 [http://localhost:4000](http://localhost:4000)

![image.png](https://img30.360buyimg.com/pop/jfs/t1/101926/5/13191/18118/5e5726ceE2ab348c3/90159b0178dfea72.png)

可以在`_post`文件夹下新增你的文章了。

![image.png](https://img30.360buyimg.com/pop/jfs/t1/93910/18/13402/306816/5e5726d1E398dd5b5/3441494ee77fb34f.png)

Happy coding .. :)

### 相关文档
[http://jekyllcn.com/docs/installation/](http://jekyllcn.com/docs/installation/)

[https://juejin.im/post/5a35ee095188252b145b1ffc](https://juejin.im/post/5a35ee095188252b145b1ffc)

[http://jekyllthemes.org/page19/](http://jekyllthemes.org/page19/)