搭建ruby + jekyll + github pages

端午节，花了2天时间学习了下ruby + jekyll + github pages，踩过不少坑，记录下学习笔记。

ruby建议是在linux环境下安装的，但是工作电脑是windows比较常见，下面记录下在windows 7 64bit版本下安装ruby + jekyll + ruby devkit的经历，进过坑，不过都爬出来了，把爬坑经历记录下方便后来者。

搭建环境： windows 7 64bit电脑举例

步骤一：下载ruby x64、ruby devkit x64、python 2.7 x64，ruby建议用2.3.3，亲测2.4.1有插件不支持，2.4.1才出不久，插件未经考验，python不强求2.7版本，只是个人习惯用这个版本了，ruby devkit可以用最新版本，下载地址：https://rubyinstaller.org/downloads/

步骤二：下载python2.7，下载地址：https://www.python.org/downloads/release/python-2713/

步骤三：下载ruby SSL证书文件，下载地址：http://curl.haxx.se/ca/cacert.pem，该证书文件待用。

步骤四：下载Git x64安装包，下载地址：https://git-scm.com/download/win，下载windows setup即可。

下载完成后，开始安装并配置环境变量，虽然安装选项中会有是否配置环境变量提示，但是仍然是习惯自己配置环境变量。

1、安装python，D:\新建PYTHON_HOME，把python27安装到D:\PYTHON_HOME\Python27下，具体过程不一一详细讲解，需要excuteInstall功能

2、安装ruby dev kit，D:\新建RubyDevKit，把DevKit解压到D:\RubyDevKit\下，具体操作不一一详细讲解，因windows环境没有linux命令，所以需要这个工具包增加操作命令。

3、安装ruby，在上一环节的D:\RubyDevKit\新建Ruby目录，把ruby安装到这个目录下。

安装完ruby dev kit和ruby后，需要执行如下安装操作：

cd D:\RubyDevKit

创建config.yml配置文件，初始化init，编辑config.yml添加上ruby的安装目录，然后review添加结果，最后执行install，没报错表示配置成功。

4、放置ruby SSL证书文件到D:\RubyDevKit\Ruby\ Ruby23-x64\bin目录下，最后开始设置环境变量

5、安装Git，直接保持默认值，一路安装完成，注意设置环境变量时要勾选设置Path。

安装完成后，开始下一步配置环境变量：

系统 - 高级系统设置 - 环境变量，新增RUBY_HOME，值为D:\RubyDevKit\Ruby\Ruby23-x64，继续新增PYTHON_HOME，值为：D:\PYTHON_HOME\Python27，继续新增SSL_CERT_FILE，值为D:\RubyDevKit\Ruby\ Ruby23-x64\bin\cacert.pem。

开始校验下安装和环境变量配置是否正确：

校验无误后，开始进行jekyll安装，

执行命令：

安装bundler

>gem install bundler

安装jekyll

>gem install jekyll

安装完成后，可以创建自己的blog目录 -这里以test名称举例截图

>jekyll new myBlog

>cd myBlog

>jekyll s

看到如下信息表示一个初步的静态blog系统搭建好

中途可能会碰到4000端口被占用情况，可以cmd进去后执行netstat -ano找到占用4000端口的pid，然后进系统进程找到对应的pid，看是哪个服务进程，可以关闭，

比如我的电脑因为安装了Foxit pdf，占用了4000，可以关闭这个无用的Foxit service。

如果没碰到4000端口占用问题，可以不理会上面的端口冲突关闭其他4000占用进程步骤，开始进一步的完善jekyll，先查看启动的服务界面。在浏览器输入

http://127.0.0.1:4000，可以看到如下界面，表示jekyll服务初步成功

这个只是demo，jekyll如果只是这么点功能，那就不推荐了，jekyll的好处就是模板多，我们可以去github上找更多精美的模板，进行二次开发。模板

地址：http://jekyllthemes.org/，如下图，有很多精美模板可供参考：

还可以下载我的个人https://github.com/anTtutu/anTtutu.github.io，我的这个也是在别人的基础上修改而来，所以下载模板进行二次开发最便捷的手段，省去美化的时间。

那么，使用他人的模板，插件库可能不一致，导致的问题有很多

首先，使用git命令下载模板库后，进入对方的模板库目录

>git clone https://github.com/anTtutu/anTtutu.github.io -- 截图以anttu工程名为例

>cd anTtutu.github.io

安装模板依赖的插件

>bundle install

更新模板依赖的插件

>bundle update

下载好模板和插件后，可以切换到模板目录再次jekyll s启动模板的工程。

>cd F:\testWorksapce\anttu

>jekyll s

检查如同demo myBlog那个启动成功没错误提示表示OK了。可以愉快的去修改、试用模板了。

模板的语法是用ruby + markdown写的，这点对于有开发基础的人来说不是问题。

Tips：

中间会碰到问题gem安装或者bundle install提示如下信息：

C:\Users\test>gem install watir
ERROR: Error installing watir:
The 'ffi' 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

解决步骤和命令如下：修复RubyDevKit的dk.rb初始化和安装

D:\RubyDevKit>ruby dk.rb init
[INFO] found RubyInstaller v1.9.3 at C:/Ruby193

Initialization complete! Please review and modify the auto-ge
'config.yml' file to ensure it contains the root directories
of the installed Rubies you want enhanced by the DevKit.

D:\RubyDevKit>ruby dk.rb install
[INFO] Updating convenience notice gem override for 'C:/Ruby1
[INFO] Installing 'C:/Ruby193/lib/ruby/site_ruby/devkit.rb'

D:\RubyDevKit>gem install rdiscount --platform=ruby
Fetching: rdiscount-1.6.8.gem (100%)
Temporarily enhancing PATH to include DevKit...
Building native extensions. This could take a while...
Successfully installed rdiscount-1.6.8
1 gem installed
Installing ri documentation for rdiscount-1.6.8...
Installing RDoc documentation for rdiscount-1.6.8...

at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit'

搭建ruby + jekyll + github pages相关推荐

如何使用Jekyll+GitHub Pages搭建个人博客站点
2019独角兽企业重金招聘Python工程师标准>>> 作为一名有情怀的工程师,一般都会通过博客来记录自己的生活,成长,工作心得或者经验,大部分人使用博客都会经历如下几个阶段: (1 ...
【GitHub.io/Github Pages使用教程】从头开始搭建自己的Github Pages，打造个人博客网站，展示个人简历、项目、文档或想要与世界共享的任何其他内容
巨人半边莲如果你曾征服乞力马扎罗山,留意过海拔 3,657-4,267 米处的尖顶植物,这种植物有时形似绿色大柱子(或'花序'),从中间长出花序. 那么你就可能看到许多巨人半边莲,这些植物生长在非洲 ...
踩坑记录丨记Jekyll + Github Pages搭建个人博客时遇到的各种问题
Author:AXYZdong 自动化专业工科男有一点思考,有一点想法,有一点理性! 定个小小目标,努力成为习惯!在最美的年华遇见更好的自己! CSDN@AXYZdong,CSDN首发,AXYZd ...
在mac上搭建octopress＋github pages博客
折腾了3天,只有这篇最靠谱 http://segmentfault.com/a/1190000000364677 注意 page已经移到.io了,请使用.io 创建仓库时,不要自动生成readme,否 ...
定制jekyll主题以及github pages部署完全总结
写在前面去年就已经开始折腾了jekyll+GitHub Pages的个人站点搭建, 一直以来的想法是自己从零开始进行前端网页的配置, 出发点是好的, 但是我发现最近已经没有时间让我折腾这些了. 恰好 ...
使用 Github Pages 和 Hexo 搭建自己的独立博客【超级详细的小白教程】
欢迎关注我的专栏:<个人博客搭建:Hexo+Github Pages>,从搭建到美化一条龙,帮你解决 Hexo 常见问题! 推荐阅读:<Hexo 博客优化之博客美化系列(持续更新)& ...
在GitHub上搭建GitHub Pages博客-- Jekyll
大约2年前,在GitHub上用Jekyll搭建了自己的博客:https://zhang0peter.com/.然后写了几篇博客后就没动过了. 然后2019年我开始在CSDN上写博客,GitHub上的博 ...
Github Pages + Jekyll 独立博客一小时快速搭建上线指南
只要一小时?! 人生道路上布满了坑,于是有了人生导师. 美丽的地球上布满了坑,于是有了Google Earth. 使用Github Pages搭建独立博客的过程中布满了坑,所以有了这篇指南. 我在 ...
m1芯片Mac安装jekyll+搭建GitHub pages个人博客站点
文章目录写在前面前期准备 GitHub Jekyll 搭建个人站点(博客) 基本的四个文件 1. _config.yml配置文件 2. _layouts/default.html网页模板文件 3. ...

搭建ruby + jekyll + github pages

搭建ruby + jekyll + github pages相关推荐

最新文章

热门文章