欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

windows安装jekyll步骤及问题

程序员文章站 2022-04-17 17:27:43
...

既然都看到这篇文章了,想必也对jekyll有所了解,我也是新手,将自己遇到的一些问题分享出来,希望能对大家有帮助。

步骤:
安装 Ruby
安装 DevKit
安装 Jekyll


1、安装 Ruby

下载地址:https://rubyinstaller.org/downloads/

windows安装jekyll步骤及问题

注意版本要选 2.0 到 3.0 之间,本文使用的是:rubyinstaller-2.2.6-x64

windows安装jekyll步骤及问题

如果是第一次安装,推荐默认路径,不要乱改路径,避免一些不必要的问题,比如我的路径是:

C:\Ruby22-x64

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

C:\Ruby22-x64\bin;

检查ruby是否正常安装,会出现版本号

ruby -v

windows安装jekyll步骤及问题

2、安装DevKit

回到刚刚的下载 ruby 的页面,往下滑。。。
下载 DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe

windows安装jekyll步骤及问题

解压文件,路径不要太长,推荐:

C:\DevKit

进入目录,初始化

ruby dk.rb init

打开 config.yml 添加

- C:/Ruby22-x64

windows安装jekyll步骤及问题

依次执行以下命令

ruby dk.rb review  # 审查(非必须)

ruby dk.rb install  # 安装

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

windows安装jekyll步骤及问题

均无报错,ok

3、安装jekyll

gem install jekyll

测试一下

jekyll --version

windows安装jekyll步骤及问题

新建项目

jekyll new myblog

如果没有任何报错,会在当前目录下回生产一个 myblog 文件夹

windows安装jekyll步骤及问题

4、运行服务器

进入 myblog 文件夹,运行服务器

cd myblog

myblog>jekyll serve

windows安装jekyll步骤及问题

访问测试:http://127.0.0.1:4000/

windows安装jekyll步骤及问题

一切都很完美,不过这才刚刚开始。。。

5、遇到的问题

问题 1:MSYS2 could not be found

运行:gem install jekyll 时报错

windows安装jekyll步骤及问题

安装msys2之后也不行,经过反复测试,发现是ruby版本的问题,注意到这句话:
For use with Ruby 2.0 to 2.3 (x64 - 64bits only)

windows安装jekyll步骤及问题

删除已安装的ruby,重新下载对应的版本
ruby: rubyinstaller-2.2.6-x64
建议将dev-kit也删除重装

问题 2:ERROR: Failed to build gem native extension

运行:gem install jekyll 时报错

windows安装jekyll步骤及问题

由于之前已经装过 dev ,重装ruby之后没有重新初始化,此处最好重新安装DevKit(查看第二步)

问题 3:cannot load such file – bundler (LoadError)

运行:jekyll serve 时报错
windows安装jekyll步骤及问题

问题 4:in any of the gem sources listed in your Gemfile. (Bundler::GemNotFound)

运行:jekyll serve 时报错

windows安装jekyll步骤及问题

问题3 问题4 基本里边有一个共同点:bundle
通过以下命令安装需要的组件

myblog>bundle install

参考文章:

  1. 《jekyll中文文档》
  2. 《Running Jekyll on Windows》
  3. 《在windows下安装jekyll - 简书》
  4. 《搭建jekyll自己的博客 - 一些问题及解决办法》
相关标签: jekyll