安装
安装完成 Jekyll 需要几分钟的时间。如果你觉得安装对你来说并不方便, 请 file an issue (或者提交一个 pull request) 来描述一下你的遭遇并告诉我们如何使这个安装过程更加便捷。
事先准备
安装 Jekyll 相当简单,但是你得先做好一些准备工作。开始前你需要确保你在系统里已经有如下配置。
- Ruby(including development headers, Jekyll 2 需要 v1.9.3 及以上版本,Jekyll 3 需要 v2 及以上版本)
- RubyGems
- Linux, Un ix, or Mac OS X
- NodeJS, 或其他 JavaScript 运行环境(Jekyll 2 或更早版本需要 CoffeeScript 支持)。
- Python 2.7(Jekyll 2 或更早版本)
在 Windows 下使用 Jekyll
虽然官方不建议在 Windows 下运行,但你可以看看这个文档: Windows 环境文档
用 RubyGems 安装 Jekyll
安装 Jekyll 的最好方式就是使用 RubyGems. 你只需要打开终端输入以下命令就可以安装了:
$ gem install jekyll
所有的 Jekyll 的 gem 依赖包都会被自动安装,所以你完全不用去担心。如果你在安装中碰到了问题,请查看 troubleshooting 或者 report an issue 那么 Jekyll 社区就会帮助你解决问题了。
安装 Xcode Command-Line Tools
如果你是Mac用户,你就需要安装 Xcode 和 Command-Line Tools了。下载方式: Preferences → Downloads → Components
。
安装预览版
要安装 Jekyll 预览版,需要在完成事先准备之后运行:
gem install jekyll --pre
这将会安装最新版本的 Jekyll。如果你想安装指定版本,只需要加上 -v
参数即可:
gem install jekyll -v '2.0.0.alpha.1'
如果你想安装 Jekyll 开发版,那就有点复杂。你将会拥有最新的特性,但是也不稳定,安装方式如下:
$ git clone git://github.com/jekyll/jekyll.git
$ cd jekyll
$ script/bootstrap
$ bundle exec rake build
$ ls pkg/*.gem | head -n 1 | xargs gem install -l
附加功能
根据每个人使用方式的不同,Jekyll 还支持你安装一些附加功能。包括了对 LaTeX 的支持,以及使用动态内容渲染引擎。查看 the extras page 获得更多信息。
已经安装老版本Jekyll?
在使用Jekyll开发之前,你可能想要检查一下你的Jekyll是不是最新版本,想要查看你的Jekyll版本,执行下面命令之一:
$ jekyll --version
$ gem list jekyll
你可以在RubyGem找到任何gem软件包的最新版本,同时也可以通过gem
命令行工具来查看:
$ gem search jekyll --remote
这样你会查到名为jekyll
的gem包,并且在方括号中显示最新版本。另一个检查本机是否是最新版本的办法是执行命令gem outdated
, 它会显示出当前系统中所有需要更新的gem包列表,如果你的jekyll不是最新版本,执行命令:
$ gem update jekyll
哦耶~你已经安装了所有需要的东西了,开始玩转 Jekyll 吧!