Jekyll Learning #04 - Mac 系统上安装 Jekyll

不能直接使用Mac自带的ruby环境就可以下载Jekyll和bundler。

Posted by WENEW on February 25, 2024

一开始我以为直接使用Mac自带的ruby环境就可以下载Jekyll和bundler了,但是一番操作之后发现并不行。无奈对ruby不是很了解,走了弯路,之后我发现在Jekyll的官方安装文档1中有关于macOS如何安装Jekyll的介绍,很快就完成了Jekyll及其依赖的安装。

安装 Brew 环境

首先你需要在终端输入,安装命令行开发工具:

1
xcode-select --install

完成之后下载本地编译版brew,大家可以参考一下《Mac配置Homebrew环境+国内源配置》

安装Ruby

使用brew安装:

1
2
3
4
brew install ruby
# 添加ruby路径到环境变量
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

然后在终端查看ruby安装位置与版本信息:

1
2
which ruby 
ruby -v

安装gem

使用ruby的包管理器gem安装Jekyll及bundle(这一步如果速度慢的话可以添加ruby的国内源镜像)

1
2
3
4
5
6
7
8
9
10
11
12
13
# 移除默认镜像
sudo gem sources --remove https://rubygems.org/
# 添加国内镜像
sudo gem sources -a http://gems.ruby-china.com/
# 查看镜像列表
gem sources -l
# 安装bundler和jekyll
sudo gem install --user-install bundler jekyll
# 安装缺失的包(也可以视情况安装,看看后面会不会因为这个包而报错)
sudo gem install webrick
# 将gem安装的包路径添加到环境变量
echo 'export PATH="$HOME/.gem/ruby/3.0.0/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

最后可以通过该代码,检查路径是否正确(正确的话会在路径中显示安装gem包的根目录)

1
gem env

查看gem版本号

1
gem –version

对比下官网的版本。可以使用以下命令更新

1
sudo gem install --system

安装jekyll

1
sudo gem install jekyll
1
sudo gem install bundler

安装依赖

1
2
sudo gem install jekyll-paginate
sudo gem install jekyll-gist

查看jekyll

检查jekyll是否成功安装

1
jekyll -v

开启服务

找到安放服务的文件夹,右键进入终端模式,输入

1
jekyll serve

参考

Jekyll on macOS

Step by Step Tutorial

m1芯片Mac安装jekyll+搭建GitHub pages个人博客站点


Author: WENEW
Link: https://www.wepro.uk/2024/02/25/Mac-%E7%B3%BB%E7%BB%9F%E4%B8%8A%E5%AE%89%E8%A3%85-Jekyll/
Liscense: All work at this site, unless otherwise noted, are not allowed to be reproduced, all rights reserved. If any post accidentally infringes your copyright, it will be removed shortly after being informed.

本站所有文章,除非另有声明,均不允许以任何形式转载,本站保留所有权利。如果本站内容不小心侵犯了您的著作权,侵权内容会在收到通知后立即删除。