Jekyll搭建github个人博客

一.Jekyll本地环境搭建

本人使用的是Window7 64位系统,所以搭建的环境是以Window系统为准,Mac系统可自行百度。

1.安装Ruby

Window安装Ruby需要使用RubyInstaller来进行安装,下载地址在这里。我这里安装的是Ruby2.3.1。
 下载好RubyInstaller点击安装,在安装界面记得勾选"Add Ruby executables to your PATH",将ruby自动加入到系统的环境变量中,省去我们自己去手动设置,然后点击安装即可。

在cmd中输入:

ruby -v

如果显示版本号则表示安装成功。

2.安装RubyDevKit

DevKit是windows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make,gcc,sh来进行编译。但是这个方法目前仅支持通过RubyInstaller安装的Ruby

点击这里下载最新的DevKit,双击运行解压到D:\MyBlog\RubyDevKit(路径可自行定义)。

打开终端cmd,输入如下命令进行安装:

cd D:\MyBlog\RubyDevKit
ruby dk.rb init

接下来需要在D:\MyBlog\RubyDevKit\config.yml 这个文件里面配置Ruby的路径,如下:

- D:/Ruby23-x64

在cmd中执行如下命令进行安装:

ruby dk.rb install
3.替换rubyGem库地址

在国内使用默认的gem源会有问题,需要重新配置gem源。这里推荐Ruby China

gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.org/
gem sources -l

如果遇到 SSL 证书问题,你又无法解决,请直接用 http://gems.ruby-china.org 避免 SSL 的问题。

D:\MyBlog\RubyDevKit>gem sources -l
*** CURRENT SOURCES ***

http://gems.ruby-china.org/
4.安装rails

cmd运行gem install rails.
cmd运行rails -v显示rails版本号说明安装成功.

5.安装Jekyll

在cmd中输入如下命令进行jekyll:

gem install jekyll

cmd运行jekyll -v验证,显示版本号说明安装成功.

二.Jekyll创建博客

当我们安装配置好jekyll后就可以进行博客的创建了,我们使用如下命令来创建一个博客:

D:\GarryBlog>jekyll new .

或者你还可以用如下命令:

D:\jekyll new GarryBlog

我们看到在GarryBlog目录下面新建了各种相关文件,但是命令行中报了一个错误,信息如下:

  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 http:/
/jekyllrb.com/help/!
jekyll 3.3.0 | Error:  bundler

这个提示告诉我们没有安装bundler,很简单,我们在命令行中输入gem install bundler进行安装即可。


创建完成后,我们就可以启动服务了,输入如下命令启动服务:

jekyll server

这时候又报另外一个错误(尼玛),信息如下:

D:\GarryBlog>jekyll server
Configuration file: D:/GarryBlog/_config.yml
Configuration file: D:/GarryBlog/_config.yml
            Source: D:/GarryBlog
       Destination: D:/GarryBlog/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
                    done in 0.252 seconds.
  Please add the following to your Gemfile to avoid polling for changes:
    gem 'wdm', '>= 0.1.0' if Gem.win_platform?
 Auto-regeneration: enabled for 'D:/GarryBlog'
Configuration file: D:/GarryBlog/_config.yml
jekyll 3.3.1 | Error:  Permission denied - bind(2) for 127.0.0.1:4000

这个错误是告诉我们4000端口被占用,解决方法是:
在_config.yml文件的末尾加上port: 5000,改为5000端口即可。
这样在浏览器中输入http://127.0.0.1:5000/ 就可以看到我们的博客了。(不容易啊~~)


三.注册Github帐号

Github网站上注册帐号,如果有则可以跳过这一步。

四.安装Git环境

这里下载安装。
安装完成后运行Git Bash。在打开的窗口中输入如下命令设置你的git用户名和邮箱:

$ git config --global user.name "{username}"          // 用你的用户名替换{username}
$ git config --global user.email "{name@site.com}"    // 用你的邮箱替换{name@site.com}

SSH配置:
为了和Github的远程仓库进行传输,需要进行SSH加密设置。

$ ssh-keygen -t rsa -C"{name@site.com}"    // 用你的邮箱替换{name@site.com}

一路敲回车即可,在C:\Users\admin.ssh 目录下会生成id_rsa 和 id_rsa.pub 两个文件,其中 id_rsa 是私钥,需要保密, id_rsa.pub 是公钥,无需保密。
在浏览器中登录你的github帐号,点击右上角的Setting-SSH and GPG keys,在SSH Key中添加 id_rsa.pub里的内容,然后点击addkey即可,这样SSH配置就完成了。

五.建立个人GitHub 博客

建议基于jekyll的个人博客有两种路线:

  • 自己学习Jekyll教程和网页设计,设计绝对自我基因的网页。
  • Fork已有的开源博客仓库,在巨人的肩膀上进行符合自我的创作。

这里介绍第二种路线,第一种路线请自行百度各种教程。

  1. 在网上搜索jekyll 网站模版,挑选一个你看上的,我们这里以 https://github.com/mzlogin/mzlogin.github.io 为例。
  2. 点击链接进入后,点击左上角的fork:


  3. 在你的主页中点击刚fork的分支,点击进入后:
    点击“Settings”,将“Repository name”改为 {你的Github用户名}.github.io,点击“Rename”。

    此时你会发现已经可以通过 http://{你的Github用户名}.github.io 访问你fork下来的网站啦!

六.写博客

  1. 同步仓库
    在Git Bash中切换到你想存放blog文件的目录下:
cd D:\GarryBlog

输入如下命令,将远程仓库克隆到本地:

git clone https://github.com/Garry2016/garry2016.github.io.git
  1. 撰写博文
    打开本地仓库的 _posts 文件夹,你的所有博文都将放在这里,写新博文只需要新建一个标准文件名的文件,在文件中编写文章内容。 比如我们fork的模版中 _posts 文件夹里有一篇 2016-03-23-hello-world.markdown,你的文件命名也要严格遵循 年-月-日-文章标题.文档格式 这样的格式,尤其要注意月份和日期一定是两位数。
    推荐使用Markdown语言写文章,windows下推荐MarkdownPad这个软件编写Markdown文本。
    最开始写可以直接模仿别人的博文语法,更多Markdown语法可参考 认识与入门Markdown

  2. 提交修改
    当你使用Git Bash对你的本地仓库进行操作时,先用 cd 命令将你的工作目录设置到你要操作的本地仓库

$ cd {你刚才clone下来的项目文件夹路径}

每当你对本地仓库里的文件进行了修改,只需在Bash中依次执行以下三个命令即可将修改同步到Github,刷新网站页面就能看到修改后的网页:

$ git add .
$ git commit -m "statement"   //此处statement填写此次提交修改的内容,作为日后查阅
$ git push origin master
  1. 实时查看本地修改的内容
    我们本地已经安装好了jekyll环境,我们可以输入 jekyll server启动服务,然后在浏览器中查看本地修改内容,方便快捷!

七.常见问题及解决方法(持续更新)

  1. 运行jekyll server后报如下错误"You have already activated addressable 2.5.0, but your Gemfile requires addressable 2.4.0. ":
D:\GarryBlog\garry2016.github.io>jekyll server
WARN: Unresolved specs during Gem::Specification.reset:
      listen (< 3.1, ~> 3.0)
WARN: Clearing out unresolved specs.
Please report a bug if this causes problems.
D:/Ruby23-x64/lib/ruby/gems/2.3.0/gems/bundler-1.13.6/lib/bundler/runtime.rb:40:in `block in setup': You have already activated addressable 2.5.0, but your Gemfile r
equires addressable 2.4.0. Prepending `bundle exec` to your command may solve this. (Gem::LoadError)
        from D:/Ruby23-x64/lib/ruby/gems/2.3.0/gems/bundler-1.13.6/lib/bundler/runtime.rb:25:in `map'
        from D:/Ruby23-x64/lib/ruby/gems/2.3.0/gems/bundler-1.13.6/lib/bundler/runtime.rb:25:in `setup'
        from D:/Ruby23-x64/lib/ruby/gems/2.3.0/gems/bundler-1.13.6/lib/bundler.rb:99:in `setup'
        from D:/Ruby23-x64/lib/ruby/gems/2.3.0/gems/jekyll-3.3.1/lib/jekyll/plugin_manager.rb:36:in `require_from_bundler'
        from D:/Ruby23-x64/lib/ruby/gems/2.3.0/gems/jekyll-3.3.1/exe/jekyll:9:in `<top (required)>'
        from D:/Ruby23-x64/bin/jekyll:23:in `load'
        from D:/Ruby23-x64/bin/jekyll:23:in `<main>'

这个问题说明本地的版本比博客需要的版本要高,只需要实行如下命令即可:

D:\GarryBlog\garry2016.github.io>gem uninstall addressable
Select gem to uninstall:
 1. addressable-2.4.0
 2. addressable-2.5.0
 3. All versions
> 2
Successfully uninstalled addressable-2.5.0

这样问题就解决了,类似问题也可以这样解决。

  1. 解决上面的问题后,再次输入jekyll server,报如下错误 "SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed":
D:\GarryBlog\garry2016.github.io>jekyll server
WARN: Unresolved specs during Gem::Specification.reset:
      listen (< 3.1, ~> 3.0)
WARN: Clearing out unresolved specs.
Please report a bug if this causes problems.
Configuration file: D:/GarryBlog/garry2016.github.io/_config.yml
Configuration file: D:/GarryBlog/garry2016.github.io/_config.yml
            Source: D:/GarryBlog/garry2016.github.io
       Destination: D:/GarryBlog/garry2016.github.io/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
   GitHub Metadata: No GitHub API authentication could be found. Some fields may be missing or have incorrect data.
  Liquid Exception: SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed in /_layouts/page.html
jekyll 3.3.0 | Error:  SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed

SSL链接问题,解决方法是点击[这里](D:\GarryBlog\garry2016.github.io>set SSL_CERT_FILE=d:\myblog\cacert.pem)下载一个cacert.pem文件保存到指定目录。然后在命令行中执行设置SSL文件的路径就可以了。

D:\GarryBlog\garry2016.github.io>set SSL_CERT_FILE=d:\myblog\cacert.pem

好了,使用jekyll搭建个人博客就写完了,还涉及一些内容这里没讲,比如评论,分享等功能。我们fork的博客里面已经实现了这些功能,大家去看源码应该就可以知道了。
有问题可以在下面留言,欢迎一起交流!

七.扩展阅读

[1]Github Pages
[2]Git教程 - 廖雪峰
[3]Jekyll中文文档
[4]认识与入门Markdown
[5]Ruby和Gem
[6]使用Github Pages建独立博客
[7]搭建一个免费的,无限流量的Blog—-github Pages和Jekyll入门

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,688评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,559评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,749评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,581评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,741评论 3 271
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,684评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,122评论 2 292
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,847评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,441评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,939评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,333评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,783评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,275评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,830评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,444评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,553评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,618评论 2 249

推荐阅读更多精彩内容