SumyBlog

    jekyll本地环境搭建

    2013-11-08 网站 jekyll 764 字 3 分钟

    用jekyll作为写作博客已经有半年多了，一直没有将搭建过程写出来。这几天正好想要给博客添加表格功能，本地环境却一直出错，遂决定重新搭建一下本地的博客环境。

    以下以 Windows 为例，说明一下本地测试环境搭建的过程。

    准备 Ruby 环境

    由于 jekyll 是用 ruby 语言写的一个静态网页生成工具，所以要搭建 jekyll 本地环境就需要先配置好 ruby 环境。鉴于本人对系统的配置也不是很熟，所以接下来的步骤能省则省。

    ①.下载 RubyInstaller ，这是 Ruby 的一个集成包，除 Ruby 之外，捆绑一些额外的资源库，能省掉一些麻烦。下载了“rubyinstaller-2.0.0-p247.exe”，记得安装的时候选上 “Add Ruby executables to your PATH” （添加系统环境变量）这样就省去了手动设置系统环境变量的麻烦，我这里安装到了 D:\Ruby200 下

    ②.下载对应版本 DevKit，我下载的是 “DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe” ，解压进行执行相关命令。我解压到了D:\devkit下，打开cmd，切换到D:\devkit下，分步执行如下的命令，出现如下提示表示安装成功了：

    D:\>cd devkit

D:\devkit>ruby dk.rb init
[INFO] found RubyInstaller v2.0.0 at D:/Ruby200

Initialization complete! Please review and modify the auto-generated
'config.yml' file to ensure it contains the root directories to all
of the installed Rubies you want enhanced by the DevKit.

D:\devkit>ruby dk.rb install
[INFO] Updating convenience notice gem override for 'D:/Ruby200'
[INFO] Installing 'D:/Ruby200/lib/ruby/site_ruby/devkit.rb'

    经过上面的两个步骤，基本的 Ruby 环境就搭建起来了。

    安装 Jekyll

    在正式安装之前，建议先修改一下 Ruby 的镜像源，以加快速度。 可以参考一下http://ruby.taobao.org/的操作步骤。

    打开命令提示符，输入下面的命令（via ruby.taobao.com）来修改镜像源：

    $ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/
$ gem sources -l
*** CURRENT SOURCES ***

http://ruby.taobao.org
# 请确保只有 ruby.taobao.org
$ gem install rails

    可能会有点慢，耐心等待一下就好。

    接下来继续输入以下命令：

    C:\>gem install jekyll
...
C:\>jekyll -v
jekyll 1.3.0

    出现版本号就代表安装成功了。期间可能会出现unable to convert "\XXX" from ASCII-8BIT to UTF-8 for XXX/XXX.XX, skipping的错误，这个忽略就行，没什么影响。

    查看一下 jekyll 的帮助文件：

    $ jekyll
  NAME:
    jekyll

  DESCRIPTION:
    Jekyll is a blog-aware, static site generator in Ruby

  COMMANDS:
    build                Build your site
    default
    docs                 Launch local server with docs for Jekyll v1.3.0
    doctor               Search site and print specific deprecation warnings
    help                 Display global or [command] help documentation.
    import               Import your old blog to Jekyll
    new                  Creates a new Jekyll site scaffold in PATH
    serve                Serve your site locally

  ALIASES:
    hyde                 doctor
    server               serve

  GLOBAL OPTIONS:
    -s, --source [DIR]
        Source directory (defaults to ./)
    -d, --destination []
        Destination directory (defaults to ./_site)
    --safe
        Safe mode (defaults to false)
    -p, --plugins PLUGINS_DIR1[,PLUGINS_DIR2[,...]]
        Plugins directory (defaults to ./_plugins)
    --layouts DIR
        Layouts directory (defaults to ./_layouts)
    -h, --help
        Display help documentation
    -v, --version
        Display version information
    -t, --trace
        Display backtrace when an error occurs

    至此，Jekyll 的本地环境搭建结束了。

    参考内容

    上一篇开始驾照学习之旅
    下一篇用Jekyll书写博客