【Jekyll搭建GITHUB个人博客】安装Ruby 环境、包管理器 RubyGems、Jekyll与错误解决

简介: 【Jekyll搭建GITHUB个人博客】安装Ruby 环境、包管理器 RubyGems、Jekyll与错误解决

今天在博客专家群看到CSDN韩俊强发表了一篇用Jekyll搭建个人博客的文章,感觉很好。

搭建博客方便很多,开始一直想着自己搭建博客,然后一直没什么时间,在做另外一个项目,所以现在就考虑用Jekyll在GITHUB上搭建博客了。


介绍下Jekyll


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


使用 Jekyll 搭建博客之前需要安装环境

Git 环境、Ruby 环境、包管理器 RubyGems、


本机已安装好了Git,就不在演示了,git的话,搜索一下,有很多教程的。祝你安装成功~


安装Ruby 环境、包管理器 RubyGems


首先去 http://rubyinstaller.org/downloads

下载需要的软件。

Ruby 2.3.3 (x64):  

image.png

DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe:

image.png


安装ruby

运行下载好的rubyinstaller-2.3.3-x64.exe

选择安装路径

我选择的是D:/Ruby23

把钩打上

image.png


安装完毕后打开cmd

输入:


ruby -v


如果显示如下说明ruby安装成功:

image.png


使用RubyInstaller的同时也安装了rubyGems

输入:


gem -v

1

如果显示如下说明rubyGems安装成功:

image.png



安装devkit!

很重要哦


安装刚刚下载的文件DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe

image.png


进入你安装devkit的主目录,按住shift,点击鼠标右键,选择在此处打开命令窗口。

如果你没有进入devkit目录打开命令窗口(CMD),就自己切换到devkit主目录下。

输入:


ruby dk.rb init


会提示你修改config.yml文件

image.png


然后你进入你安装的devkit的主目录下,去修改config.yml文件。

如果你没有运行该命令,可以自己建文件,然后配置。

原文件为:

image.png


修改为:

image.png


- D:/Ruby23
- D:/Ruby23


注意不要写成反斜杠!是/


这两个目录分别为你Ruby和devkit的安装目录。

如果和我安装的目录不在同一个下面,不要和我的写成一样了哦。


保存后关闭文件。

再输入命令


ruby dk.rb install


安装成功:

image.png


这里可能会有一个错误

image.png

尚无法解决,该错误请参考stackoverflow网址:

http://stackoverflow.com/questions/18803223/unable-to-find-rubygems-in-site-ruby-or-core-ruby

我的解决办法是重新装了一遍,把路径改成这样的。


ruby,rubygems,devkit的安装完毕了

运行:


gem install mongo


image.png


获取最简单 Jekyll 模板并生成静态页面


需要的环境搭建好了之后,就是获取最简单 Jekyll 模板并生成静态页面、


安装 jekyll


gem install jekyll


等待下载完成…

image.png


切换到你需要下载模板到那里的目录的上一级

我这里的目录是G:\Github\myBlog,我想把模板下载到myBlog目录下。

切换的G:\Github下输入:


jekyll new myblog


在这里你可能会遇到一个错误,见错误二(没有的,可忽略),该错误课看本篇后面的可能的错误以及解决办法。

image.png

如果没有错误出现,就是下面这种情况

image.png

image.png


恭喜。


接下来切换到myblog目录下面、

image.png


输入:


jekyll serve


image.png


这个时候就可以访问:

http://localhost:4000/

image.png


祝大家安装成功。


可能的错误以及解决办法


错误一:


Fetching: bson-4.2.1.gem (100%) 
ERROR: Error installing mongo: 
The ‘bson’ native gem requires installed build tools. 
Please update your PATH to include build tools or download the DevKit 
from ‘http://rubyinstaller.org/downloads’ and follow the instructions 
at ‘http://github.com/oneclick/rubyinstaller/wiki/Development-Kit’

image.png


解决办法


安装刚刚下载的DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe就可以了。

见前面的安装devkit。


错误二


运行 jekyll new myblog 的时候出现该错误:


Dependency Error: Yikes! It looks like you don't have bundler or one of its de
pendencies installed. In order to use Jekyll as currently configured, you'll nee
d to install this gem. The full error message from Ruby is: 'cannot load such fi
le -- bundler' If you run into trouble, you can find helpful resources at https:
//jekyllrb.com/help/!
jekyll 3.4.3 | Error:  bundler


解决办法


请安装bundler:


gem install bundler


然后安装bundle,bundle install

image.png


错误三


Conflict: G:/Github/myBlog exists and is not empty.


解决办法


删除myBlog 下的所有文件即可解决


目录
相关文章
|
8月前
|
存储 JavaScript 网络架构
【开源图床】使用Typora+PicGo+Github+CDN搭建个人博客图床
【开源图床】使用Typora+PicGo+Github+CDN搭建个人博客图床
310 3
|
8月前
|
Shell 网络安全 开发工具
Github Pages + Jekyll 独立博客一小时快速搭建&上线指南
Github Pages + Jekyll 独立博客一小时快速搭建&上线指南
|
Linux Ruby Windows
|
5月前
|
Linux 网络安全 API
【Azure 应用服务】App Service For Linux 环境中,如何从App Service中获取GitHub私有库(Private Repos)的Deploy Key(RSA key)呢?
【Azure 应用服务】App Service For Linux 环境中,如何从App Service中获取GitHub私有库(Private Repos)的Deploy Key(RSA key)呢?
|
8月前
|
资源调度 前端开发 JavaScript
不花一分钱,用Hexo和GitHub Pages搭建个人博客🏢
不花一分钱,用Hexo和GitHub Pages搭建个人博客🏢
188 0
|
7月前
|
JavaScript 应用服务中间件 程序员
技术人如何利用 github+Jekyll ,搭建一个独立免费的技术博客
技术人如何利用 github+Jekyll ,搭建一个独立免费的技术博客
|
8月前
|
JavaScript 网络安全 开发工具
[保姆级-从0到1]利用hexo+github托管实现搭建个人博客
[保姆级-从0到1]利用hexo+github托管实现搭建个人博客
|
8月前
|
程序员 API Android开发
使用 VS Code + Github 搭建个人博客
搭建个人博客的方案
100 1
|
8月前
|
数据采集 XML 数据格式
Ruby详解及安装流程
Ruby是一种高级编程语言,具有简单易学、灵活多变、优雅美丽的语法特点。它是一种面向对象的编程语言,具有动态类型和解释型语言的特性。在Ruby中,可以使用简单易懂的语法来编写代码,实现各种功能,如Web开发、网络编程、脚本编写、GUI开发等。
346 0
|
8月前
|
编译器 定位技术 开发工具
分布式版本控制系统Git的下载、安装与使用其复制GitHub项目代码的方法
分布式版本控制系统Git的下载、安装与使用其复制GitHub项目代码的方法
102 1
下一篇
开通oss服务