Mac如何安装jekyll?

一、安装Ruby

其实mac自带ruby，但是安装的时候不能使用自带的ruby软件，因为自带的权限为system，导致安装的时候权限不够安装失败，

所以我们需要自己安装一个ruby软件。

使用rvm安装ruby

RVM 是一个命令行工具，可以提供一个便捷的多版本 Ruby 环境的管理和切换。

安装rvm

curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile

使用rvm安装ruby

rvm install ruby-3.0.0   // 安装最新的ruby软件（我安装的是3.0.0）

注意：如果安装ruby-3.0.0报错，可以使用该命令安装rvm install ruby-3.0.0 --with-openssl-dir='brew --prefix openssl'。错误如下：

Error running ' CFLAGS=-O3 -I/usr/local/opt/libyaml/include -I/usr/local/opt/libksba/include -I/usr/local/opt/readline/include -I/usr/local/opt/
zlib/include -I/usr/local/opt/openssl@1.1/include -I/usr/local/opt/libyaml/include -I/usr/local/opt/libksba/include -I/usr/local/opt/readline/
include -I/usr/local/opt/zlib/include -I/usr/local/opt/openssl@1.1/include LDFLAGS=-L/usr/local/opt/libyaml/lib -L/usr/local/opt/libksba/lib -L/
usr/local/opt/readline/lib -L/usr/local/opt/zlib/lib -L/usr/local/opt/openssl@1.1/lib -L/usr/local/opt/libyaml/lib -L/usr/local/opt/libksba/lib
-L/usr/local/opt/readline/lib -L/usr/local/opt/zlib/lib -L/usr/local/opt/openssl@1.1/lib ./configure --prefix=/Users/name/.rvm/rubies/ruby-3.0.0
--disable-install-doc --enable-shared', please read /Users/name/.rvm/log/1615658870_ruby-3.0.0/configure.log There has been an error while
running configure. Halting the installation.

切换ruby为我们刚安装的版本
```
rvm use 3.0.0
```

二、安装jekyll

使用gem安装jekyll

RubyGems软件允许您轻松下载、安装和使用ruby在您的系统软件包。这个软件包被称为“Gem”和包含一个Ruby包应用程序或库。

因为国内访问gem源比较慢，设置安装失败，所以可以切换国内源提升速度。

切换gem源

gem sources -r https://rubygems.org/ -a https://gems.ruby-china.com/

安装jekyll

sudo gem install jekyll      		// 第一种方式
sudo gem install github-pages   // 第二种方式(该方式会按照github pages的版本安装jekyll)

设置PATH路径

在.bash_profile文件中添加如下内容，路径替换成自己的真实路径
```
export jekyll='/Users/xxx/.rvm/rubies/ruby-3.0.0'
export PATH=$PATH:$jekyll/bin
```

三、下载jekyll主题

通过jekyll主题网站下载喜欢的主题

四、启动jekyll服务

解析主题压缩包，进入主题文件夹，执行以下指令：

bundle install
jekyll server

五、（重点）安装过程中的异常梳理

1. 安装jekyll的时候可能会让升级homebrew，但是升级的时候报如下错误：

解决方案：

先删除/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core再重新执行brew upgrade即可。(如果升级太慢，可以切换brew国内源)

2. 安装jkeyll的时候可能还会报openssl/ssl.h找不到错误

解决方案：

此时先看openssl是否已安装，通过brew install openssl安装openssl，如果已安装不会重复安装；

如果安装好之后依旧找不到，可以通过 brew info openssl查看openssl的安装路径。然后将include包下的内容复制到xcode

的/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform

/Developer/SDKs/MacOSX.sdk/usr/include/文件夹下即可。

如果仍然报错，执行brew link --force openssl。

如果仍然报错，执行gem install eventmachine -v 1.2.7 -- --with-cppflags=-I/usr/local/opt/openssl/include命令，其中的1.2.7替换为你需要的版本，/usr/local/opt/openssl/include 替换为通过brew info openssl得到的openssl的路径。

3. 使用rvm use xxx报错RVM is not a function

解决方案： 在使用rvm use xxx命令之前先执行如下命令：
source ~/.rvm/scripts/rvm

3. 启动jekyll服务的时候可能会报如下错误

解决方案：

执行 sudo gem install kramdown-parser-gfm 安装kramdown-parser-gfm；

执行sudo gem install bundler:2.2.3安装bundler；

修改项目目录下的gemfile，添加 gem “kramdown-parser-gfm”；

gemfile中会设置source，可以通过bundle config mirror.https://rubygems.org https://gems.ruby-china.com配置国内源。

执行bundle install 。

最后：如果仍报错，缺少什么安装什么，注意安装的时候要使用自己安装的ruby版本，切换版本用rvm use 3.0.0。