Skip to content

Jekyll

jekyll 官方安装文档 :https://jekyllrb.com/docs/installation/ubuntu/

1. 安装依赖项

安装 Ruby 和其他先决条件

sudo apt-get install ruby-full build-essential zlib1g-dev

避免以 root 用户身份安装 RubyGems 包(称为 gems)。相反,为您的用户帐户设置 gem 安装目录。以下命令将向您的 ~/.bashrc 文件添加环境变量,以配置 gem 安装路径:

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

先配置gem国内源,再安装下面的

使用以下命令替换 gems 默认源 清华源help: https://mirrors.tuna.tsinghua.edu.cn/help/rubygems/

# 添加镜像源并移除默认源
gem sources --add https://mirrors.tuna.tsinghua.edu.cn/rubygems/ --remove https://rubygems.org/
# 列出已有源
gem sources -l
# 应该只有镜像源一个

最后,安装 Jekyll 和 Bundler:

gem install jekyll bundler

安装完 jekyll 、bundler 下一步 使用以下命令替换 bundler 默认源

bundle config mirror.https://rubygems.org https://mirrors.tuna.tsinghua.edu.cn/rubygems

2. 检查一众依赖项

https://jekyllrb.com/docs/installation/#requirements

ruby -v
gem -v
gcc -v
g++ -v
make -v

3. GitHub Pages 官方文档

https://docs.github.com/zh/pages/quickstart

https://docs.github.com/zh/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll

当然在我用wsl 作为jekyll 服务环境的时候我遇到了一个问题 就是 ,bundle exec jekyll serve 出现一个权限问题,提示我加载本地文件没有权限,当然使用 sudo bundle exec jekyll serve 可以正常运行