一、安装Ruby

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

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

使用rvm安装ruby

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

  1. 安装rvm

    curl -L get.rvm.io | bash -s stable
    source ~/.bashrc
    source ~/.bash_profile
    
  2. 使用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.
    
  3. 切换ruby为我们刚安装的版本

    rvm use 3.0.0
    

二、安装jekyll

使用gem安装jekyll

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

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

  1. 切换gem源

    gem sources -r https://rubygems.org/ -a https://gems.ruby-china.com/
    
  2. 安装jekyll

    sudo gem install jekyll      		// 第一种方式
    sudo gem install github-pages   // 第二种方式(该方式会按照github pages的版本安装jekyll)
    
  3. 设置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,但是升级的时候报如下错误:

image-20220129082320182

解决方案:

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

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

解决方案:

  1. 此时先看openssl是否已安装,通过brew install openssl安装openssl,如果已安装不会重复安装;

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

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

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

  3. 如果仍然报错,执行brew link --force openssl
  4. 如果仍然报错,执行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服务的时候可能会报如下错误

image-20220129085428933

解决方案:

  1. 执行 sudo gem install kramdown-parser-gfm 安装kramdown-parser-gfm;

  2. 执行sudo gem install bundler:2.2.3安装bundler;

  3. 修改项目目录下的gemfile,添加 gem “kramdown-parser-gfm”;

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

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