使用 Jekyll 搭建博客

Jekyll 是一个免费的开源静态网站生成器，主要用于将纯文本转换为静态的 HTML、CSS 和 JavaScript 文件，从而生成完整的静态网站。 Jekyll 官网：https://jekyllrb.com/

1.安装前提

Jekyll 支持大多数操作系统，依赖如下：

• Ruby 2.5.0+
• RubyGems
• GCC 和 Make

2.安装 Ruby

本文环境为 Windows 操作系统，通过 RubyInstaller 进行安装 Ruby，前往 RubyInstaller 下载地址，下载相应的 Ruby 安装程序，然后运行安装程序，确保在安装过程中选中Add Ruby executables to your PATH以便于在命令行中使用 Ruby。

在弹出的命令行窗口中选择 MSYS2 and MINGW development tool chain。

检查是否安装成功：

ruby -v 
gem -v

3.安装 Jekyll

打开新的命令行，使用 gem 安装 Jekyll 和 Bundler。

gem install jekyll bundler

由于默认的下载源非常慢，可以使用以下命令更换下载源，使用 gem source 命令查看默认下载源后，删除默认的下载源。

gem source
gem source -r https://rubygems.org/

添加新的下载源后，使用 gem source 命令验证。

gem source --add https://gems.ruby-china.com
gem source

检查是否安装成功：

jekyll -v

4.快速创建

Jekyll 安装好后，使用以下命令可以快速创建一个新的 Jekyll 网站。

jekyll new my_blog
cd my_blog
bundle exec jekyll serve

在浏览器访问 http://127.0.0.1:4000/。

5.Jekyll 目录结构

一个基本的 Jekyll 网站的目录结构如下：

.
├── _config.yml
├── _drafts
|   ├── begin-with-the-crazy-ideas.textile
|   └── on-simplicity-in-technology.markdown
├── _includes
|   ├── footer.html
|   └── header.html
├── _layouts
|   ├── default.html
|   └── post.html
├── _posts
|   ├── 2007-10-29-why-every-programmer-should-play-nethack.textile
|   └── 2009-04-26-barcamp-boston-4-roundup.textile
├── _site
├── .jekyll-metadata
└── index.html

文件/目录	描述
_config.yml	配置文件
_posts	文章内容，文件命名格式为YYYY-MM-DD-TITLE.EXTENSION
_site	Jekyll 生成的网站文件
assets/images	文章中的图片文件
index.html	网站主页

详见官方文档 Directory Structure。

6.主题

Jekyll 提供了网站页面的布局和样式，详见官方文档 Themes。若要安装一套主题，需要先在 Gemfile 文件中添加如下内容：

gem 'jekyll-theme-chirpy'

在命令行执行bundle install命令安装主题，最后在_config.yml文件中启用主题。

theme: jekyll-theme-chirpy