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 查看 gemruby 版本,,然后需要安装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/

评论加载中