Jekyll 是一个静态站点生成器,内置 GitHub Pages 支持。默认情况下,GitHub Pages 将使用 Jekyll 来构建站点。这里记录下这个博客的搭建过程。

Installation

我是在 VirtualBox 中新建了 Ubuntu 虚拟机,在虚拟机中安装的

首先,需准备 Ruby 开发环境

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

可通过以下命令检查是否已安装,ruby 版本需在 2.5.0 或以上版本

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

然后用 RubyGems 安装 Jekyll 和 bundler

gem install jekyll bundler

至此,安装完成

Create a Jekyll site

新建 repository,username 为 github 用户名

git init <username>.github.io
cd <username>.github.io
jekyll new .

更新Gemfile,使用 Github Pages

# 注释gem "jekyll"
# gem "jekyll", "~> 4.1.1"

# 取消注释gem "github-pages"
gem "github-pages", group: :jekyll_plugins

更新后安装

bundle install

# 执行后提示有版本问题,需执行bundle update
bundle update

然后就可以在本地预览了

bundle exec jekyll serve

预览没问题后提交代码,准备部署

git add .
git commit -m 'jekyll default'

Deployment

在 github 中新建<username>.github.io仓库,把站点推送到新建的仓库中,然后就可以在https://username.github.io 中浏览了

git remote add origin <url>
git push -u orgin master