无心 | 人生若只如初见，何事秋风悲画扇
2017-05-24 | jekyll | UNLOCK

记录一下jekyll安装及遇到的问题

本文参照了https://blog.csdn.net/mouday/article/details/79300135

电脑环境

  • win7 x64

软件版本

  • 因为 jekyll 主题时基于 ruby 系统的，所以在安装jekyll之前，需要安装 ruby ,

安装 ruby

  • 去官网下载 ruby https://rubyinstaller.org/downloads/

  • 我下载的是 Ruby 2.2.6(x64) 版本的。

  • 下载之后跟一般软件的安装步骤差不多，可以选择默认安装路径，也可以安装自己选择的路径，比如我就选择的时候D盘下 d:Ruby22-x64 安装

  • 安装的时候注意勾选把ruby添加到路径PATH，如果不勾选也可以手动添加，例如，按照我的路径，就应该添加：

    1
    D:\Ruby22-x64\bin;

  • 检查一下之前安装的 ruby 是否安装成功。会出现版本号

    1
    ruby -v

安装 Devkit

  • 回到刚才下载 ruby 的网址，往下翻，找到

  • 下载之后，安装，建议跟 ruby 安装在同一层级下，另外安装的时候，创建一个文件夹 devkit，因为从网上下载的 devkit是个压缩包，解压之后文件是散的，推荐：

    1
    d:\Devkit

  • 安装之后，进入 devkit 文件目录，进行初始化

    1
    ruby dk.rb init

  • 打开 devkit 文件夹内的 config.yml 文件,添加

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
        D:/Ruby22-x64   //这个就是你安装 `ruby` 的路径
      ```  

    ![](https://i.imgur.com/FihfLJN.png)
      - 然后依次输入以下命令

      ```gem
          ruby dk.rb review  # 审查（非必须）

          ruby dk.rb install  # 安装

          gem -v  # 查看gem是否正常安装

  • 如果依次出现上面的内容，说明安装没有问题

安装jekyll

  • 这里使用 gem 命令安装

    1
    gem install jekyll

  • 如果对 jekyll 安装版本有要求，可以使用

    1
    gem install jekyll --version=3.2.1 // 语法:gem install jekyll --version=(版本号)

  • 如果出现上述提示，表明安装成功，如果不放心，可以查看一下 jekyll 

    1
    jekyll --version

  • 然后建立属于自己的blog

    1
    jekyll new blog

  • 进入自己的 myblog 文件夹

  • 然后运行jekyll,这个时候噩梦也就就此展开，问题也来了

    1
    jekyll serve

遇到的问题

  1. 运行jekyll出问题了

  • 解读：问题主要是：运行 jekyll 的时候，核心： _ 54 require.rb 在 require 搜索 ：无法加载文件（loaderror -捆包机），说明本地缺少 bundler 组件

  • 只要安装 bundle 就行，进入自己新建的 myblog 路径下，输入：

    1
    gem install bundle

  • 出现这个信息说明安装 bundle 组件成功
  • 由于jekyll是依赖于bundle
    • 开始 jekyll 服务,进而引发第二个问题
1
bundle exec jekyll serve

  • 解决 bundle 组件之后

  • 解读：既然说gem 缺少minima (~> 2.0),我们安装不就得了,安装minima

  • 安装 minima

    1
    gem install minima

    • 没有报错，说明安装OK
  • 再次运行 jekyll ，好像依旧报错，也是跪了
    • 看到提示也是不解，我刚才不是安装了 minima 了嘛,咋说找不到该文件呢，原来不是因为没有安装，而是ruby版本太过古老，需要安装2.3版本之后的,what?,就这一句话，就要我重安？心中只想骂人了
    • 骂完也只能默默的重安啊。

解决问题

  • 这个因为做的时候，没有实时记录笔记，所以是凭借记忆写的，会有一些缺失。可以参考上面写的，做个对照，基本步骤是一样的。只不过这次下载的集成版本，有些东西会默认给配置好，省去很多事。

  • 因为担心 ruby 版本太高，跟之前弄的不兼容，所以，就弄了一个 ruby-2.3.2 下载，然后按照之前写的步骤安装，安装之后，输入 ruby -v 可以查看，然后需要重新进 Devkit 文件夹内，初始化一下，然后依次输入安装 devkit时的三个一起的命令。这个时候在安装 gem的时候可能会出错，应该是提示 devkit 版本也要2.3版本以上的，所以，又要卸载之前的 devkit，去他们官网下载

  • 当我从他们官网逛一圈之后，发现好像没有2.3版本的独立 Devkit 文件下载。所以只能下载ruby+Devkit集成的文件

  • 下载安装之后，可以直接通过 gem -v 以及ruby -v 查看 gem 跟 ruby 版本,，然后需要安装jekyll，可以直接用 gem jekyll install 安装。安装之后，新建一个 myblog文件 ，然后切换到 myblog 路径下，运行 jekyll ,当出现 ,运行的时候或许会提示你需要安装 minima 组件，按要求安装就可以。

  • 安装之后，再运行 jekyll ，这个时候可能会出现

    • 这个说是缺少 jekyll-paginate 分页插件，按要求下载安装就可以

  • 当安装 jekyll-paginate 之后再次提示 jekyll-paginate 错误，这个时候可以将 gem "jekyllpaginate",group: :jekyll_plugins 加到创建的文件夹中文件名为 Gemfile 中， 此时再次运行服务器，就不会报错了。

新问题

正在每天记录脑中的知识时，突然发现，文章更新到 github 上之后，虽然github上能看到文章，但是不管是配置还是页面都没有更新了！

查了很多资料，但是奈何自己是个英语渣渣。每次看官方文档，都需要翻译
最终发现，在每次提交GitHub的时候，GitHub就已经给我提示了，但是我英语渣渣，看不懂，并且给出了问题解答。

看来还是得花一些时间学一下英语啊

https://help.github.com/articles/troubleshooting-github-pages-builds/

jekyll安装 遇到的问题

评论加载中