Ruby 101

Jekyll 使用 Ruby 编写,如果你还不太了解 Ruby ,阅读本文你可以学习到一些基本的术语。

Gem

Gem 是可以包含在 Ruby 项目中的代码包。Gem 提供了特定的功能,你可以多个项目中使用它或者共享给他人使用。Gem 可以处理很多事,比如:

  • 将 Ruby 对象转换为 JSON
  • 实现分页功能
  • 与 GitHub 等网站的 API 进行交互

Jekyll 就是一个 gem。许多 Jekyll 插件 也是 gem,比如 jekyll-feedjekyll-seo-tagjekyll-archives

Gemfile

Gemfile 文件是你项目(网站)的 gem 配置列表。每个 Jekyll 网站的主文件夹根目录下都有一个 Gemfile 文件。

一个简单的 Jekyll 网站,它的 Gemfile 文件可能是这样的:

source "https://rubygems.org"

gem "jekyll"

group :jekyll_plugins do
  gem "jekyll-feed"
  gem "jekyll-seo-tag"
end

Bundler

Bundler 可以用来安装 Gemfile 文件中配置的 gem ,你可以把它理解为一个安装器(有点像360中的软件管理,你可以轻易安装某个软件)或者驱动器(有点像浏览器,你可以在任何电脑打开某个网站)。

构建 Jekyll 并非必须使用 Gemfilebundler,但推荐使用 Gemfilebundler ,因为它可以确保你在不同(系统)环境中使用相同版本的 Jekyll 和插件(就有点像浏览器,你再哪儿都可以通过网页登录你的微信,而不用考虑系统环境等因素)。

使用 gem install bundler 命令安装 Bundler。Bundler 只需要安装一次,再次创建新的 Jekyll 项目时无需再次安装。

使用 Bundler 安装 Gemfile 中的 gem,只需在包含 Gemfile 文件的目录运行以下命令:

bundle install
bundle install
bundle exec jekyll serve

如果你不想使用 Gemfile 和 Bundler,可以去掉命令中 Bundler 相关参数,使用 jekyll serve 直接运行 Jekyll。

可查看 使用 Jekyll 和 Bundler 文档,了解更多关于使用 Bundler 运行 Jekyll 的内容,以及如何快速启动 Jekyll。