mac 安装 jekyll

Jekyll 介绍

Jekyll 是将纯文本转化为静态网站和博客的项目。官网 描述是这样的：

`Jekyll` 是一个简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过 `Markdown` （或者 `Textile`） 以及 `Liquid` 转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。`Jekyll` 也可以运行在 `GitHub Page` 上，也就是说，你可以使用 `GitHub` 的服务来搭建你的项目页面、博客或者网站，而且是完全免费的。
复制代码

Jekyll 安装

前提

安装 Jekyll 是非常简单的，但是事先你必须做好一些准备工作，确保你的机器上配置了

• Ruby

• RubyGems

• Linux, Unix, or Mac OS X

注意：在 windows 下使用 Jekyll，你可以使用 Running Jekyll on Windows

安装

借助 RubyGems 安装 Jekyll

安装 Jekyll 的最好方式就是使用 RubyGems. 你只需要打开终端输入以下命令就可以安装了：

    sudo gem install jekyll
复制代码

所有的 Jekyll 的 gem 依赖包都会被自动安装，所以你完全不用去担心。如果你在安装中碰到了问题.

注意：Mac 需要安装 Xcode 和 Command-Line Tools了。下载方式 Preferences → Downloads → Components。

初始化项目

打开终端找到自己喜欢的目录执行

    jekyll new projectName[项目的名称]
复制代码

启动项目

终端指向刚才新初始化的项目目录下，然后执行

    jekyll server
复制代码

正常情况下会输出如下内容

    Configuration file: /Users/[用户名]/StudyCloud/Blog/myblog/_config.yml
                Source: /Users/[用户名]/StudyCloud/Blog/myblog
           Destination: /Users/[用户名]/StudyCloud/Blog/myblog/_site
     Incremental build: disabled. Enable with --incremental
          Generating... 
                        done in 0.382 seconds.
     Auto-regeneration: enabled for '/Users/lane/StudyCloud/Blog/myblog'
        Server address: http://127.0.0.1:4000/
      Server running... press ctrl-c to stop.
复制代码

启动的服务是监听 4000 端口的。

如果是异常情况，可能会输出如下内容

/usr/local/Cellar/ruby/2.4.3_1/lib/ruby/2.4.0/rubygems/core_ext/kernel_require.rb:55:in `require': cannot load such file -- bundler (LoadError)
	from /usr/local/Cellar/ruby/2.4.3_1/lib/ruby/2.4.0/rubygems/core_ext/kernel_require.rb:55:in `require'
	from /usr/local/lib/ruby/gems/2.4.0/gems/jekyll-3.6.2/lib/jekyll/plugin_manager.rb:48:in `require_from_bundler'
	from /usr/local/lib/ruby/gems/2.4.0/gems/jekyll-3.6.2/exe/jekyll:11:in `<top (required)>'
	from /usr/local/bin/jekyll:23:in `load'
	from /usr/local/bin/jekyll:23:in `<main>'
lanedeMacBook-Pro:myblog [用户名]$ gem install bundler
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.
复制代码

如果异常情况和这个一致，那么问题就好解决了。

• 1、第一句话是说 bundler 这个包没有找到。既然没有找到那就安装一个，执行命令 sudo gem install bundler.

• 2、安装完后，迫不及待的执行了一下 jekyll server 又发现报错

/usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/resolver.rb:289:in `block in verify_gemfile_dependencies_are_found!': Could not find gem 'minima (~> 2.0)' in any of the gem sources listed in your Gemfile. (Bundler::GemNotFound)
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/resolver.rb:257:in `each'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/resolver.rb:257:in `verify_gemfile_dependencies_are_found!'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/resolver.rb:48:in `start'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/resolver.rb:22:in `resolve'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/definition.rb:257:in `resolve'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/definition.rb:170:in `specs'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/definition.rb:237:in `specs_for'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/definition.rb:226:in `requested_specs'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/runtime.rb:108:in `block in definition_method'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler/runtime.rb:20:in `setup'
	from /usr/local/lib/ruby/gems/2.4.0/gems/bundler-1.16.1/lib/bundler.rb:107:in `setup'
	from /usr/local/lib/ruby/gems/2.4.0/gems/jekyll-3.6.2/lib/jekyll/plugin_manager.rb:50:in `require_from_bundler'
	from /usr/local/lib/ruby/gems/2.4.0/gems/jekyll-3.6.2/exe/jekyll:11:in `<top (required)>'
	from /usr/local/bin/jekyll:23:in `load'
	from /usr/local/bin/jekyll:23:in `<main>'
复制代码

• 3、这报错越来越可怕了。虽然可怕但是总有解决的办法，继续执行 bundle update

• 4、命令执行完后，再执行 bundle exec jekyll serve 或者 jekyll serve 就 OK 了。