jekyll.png

原创精选来自我的博客文章

目录

说在前面的话

作为一个和电脑、代码打交道的我，一直都想拥有自己的博客，一切都显得那么高(zhuang)大(bi)上(yong)，在下定决心之后就在网上到处查找资料，最终发现一般用的就三种：WordPress、Hexo、Jekyll，最终权衡利弊选定了jekyll来实现博客搭建。

这个过程前前后后遇到很多坑，虽然有相关文档，毕竟总不够全面，在自己这里也有时候会出现一些他们没碰到的问题，总体比较艰辛，所以也要记录下自己搭建的过程，同时一直更新遇到的新问题，在使用过程中出现问题，可直接跳到末尾的Q&A进行查看是否有类似问题。

jekyll介绍

jekyll是一个简单的免费的Blog生成工具，一个生成静态网页的工具，不需要数据库支持，只用 Markdown (或 Textile)、Liquid、HTML & CSS 就可以构建可部署的静态网站，最关键的是jekyll可以免费部署在Github上，而且可以绑定自己的域名。

至于更多详细信息可以直接查看相关文档：jekyll中文文档、jekyll英文文档

jekyll安装

1、事先准备

安装 Jekyll 相当简单，但是你得先做好一些准备工作 开始前你需要确保你在系统里已经有如下配置

Git环境(部署到远端以及代码管理)

Ruby环境(jekyll基于Ruby开发)

Linux, Unix, or Mac OS X(官方文档并不建议在Windows平台安装)

Mac用户需要安装Xcode和Command-Line Tools，下载方式Preferences → Downloads → Components

2、RubyGems 安装 Jekyll并启动

安装 jekyll

$ gem install jekyll

创建博客

$ jekyll new myBlog

进入博客目录

$ cd myBlog

启动本地服务

$ jekyll serve

在浏览器里输入： http://127.0.0.1:4000，就可以看到你的博客效果了。

初版博客

1、目录结构

基本jekyll网站启动后，本地目录结构如下，至于目录结构意义，可以参考官方文档目录结构

.

├── _config.yml

├── _includes

| ├── footer.html

| └── header.html

├── _layouts

| ├── default.html

| ├── post.html

| └── page.html

├── _posts

| └── 2016-01-01-welcome-to-jekyll.markdown

├── _sass

| ├── _base.scss

| ├── _layout.scss

| └── _syntax-highlighting.scss

├── about.md

├── css

| └── main.scss

├── feed.xml

└── index.html

看能力去自行修改对应文件，重新 jekyll serve 就可以看到效果，有些修改并不需要重新运行这个命令，具体的可尝试下就知道。

2、编写博客文章

这里所有的博客文章都是放在 _post 目录下面

文章命名格式：yyyy-mm-dd-title.md，后缀可以是.md 或者 .markdown，如：2016-01-02-firstBlog.md

文章内容格式如下，其中每篇文章头部都是固定的

---

layout: post

title: "firstBlog"

date: 2016-01-02

categories: blog

---

正文...

title：文章内部标题；这里的标题和.md文章命名有一定区别，这里的标题是查看文章的时候显示在顶部，而.md文章名是显示在网址中，也就是该文章的URL

date：日期

categories：标签；目前只能有一个标签

如果对markdown不熟悉，可参考另一篇文章 markdown基本语法学习

注意：模板是支持markdown语法，但不是支持全部语法，所以这个方面是有待改进。

3、部署到远端

这里是部署到GitHub Page，除了这个也可以部署到 Gitlab、Coding等，主要就是当做一个免费的服务器使用。

github 上创建一个仓库，命名为 username.github.io，例如我的仓库就是 honeycao.github.io，这个是一个命名规范。

本地创建好的博客用git管理，然后推送到GitHub上(远程仓库中不需要README.md文件，本地需要新建一个README.md文件用于推送到远端)

$ cd myBlog

$ git init

$ git add README.md

$ git commit -m "first commit"

$ git remote add origin git@github.com:honeycao/test.git

$ git push -u origin master

检测是否同步成功，成功之后再浏览器中输入 username.github.io 就可以访问该博客

博客模板

毕竟不是所有人都会css、js和html，所以有一个模板就显得很关键了，jekyll官方也提供了 jekyll主题，基于模板只需简单修改就可以使用了。

如果对于我博客模板有兴趣的，可以到我的 GitHub博客 进行查看，或者下载下来运行看看，终端进入目录下，运行 jekyll serve，然后在浏览器里输入： http://127.0.0.1:4000，就可以看到我的博客效果了。

注意：由于我的博客使用了自定义的域名，所以第一次下载使用，需要修改域名，具体做法： 到目录下打开CNAME文件，清空我的域名信息即可，如果你有自己的域名，也可以将其修改为你的域名。

如果想在我的博客基础上修改成你的博客，那么需要修改下面几个地方

把 _posts/ 目录下的文章都去掉。

把 images/ 目录下图片替换，把 images/posts/目录下 博客相关图片去掉

修改 _config.yml 文件里面的内容为你自己的。

拓展工具

在我自己的博客中，除了模板自有功能之外，也添加了许多拓展的工具，如：评论、分享等，这里就介绍下我自己的经验，这些拓展工具并不统一，只是作为一个参考而已，仁者见仁智者见智，另外小伙伴们如果有更好的拓展工具也可以介绍给我，不胜感激。。。

1、域名

如果没有自己的域名，那么博客网址就是 username.github.io，看起来总不是那么好，所以有兴趣就可以购买一个自己的域名玩玩，至于购买哪样的那看你自己的经济了；

购买途径网上也有很多，这里也不多作介绍，主要说下域名解析的问题，一般购买域名的地方都可以免费解析，比如我是在 百度云 买的，同时可以免费解析，如果没有地方解析，那么介绍一个可以免费解析的地方——DNSPOD，不管在哪解析，解析步骤都是一样的，我自己在解析的时候就碰到一个问题，耽搁好久才解决，所以下面就贴出正确解析的方法

域名解析

主要注意记录值填写自己博客仓库名就行

2、数据统计

百度统计：统计网站访问详情，不过由于才疏学浅并不能导出统计数据，所以只是用来作为一个流量页面展示

不蒜子：和百度统计相辅相成，这个只能用于获取统计数据，而并没有展示页面

3、评论

由于多说6月初就停用了，所以也不考虑它

畅言：一开始想的是这个，但是由于自己的域名并没有备案，所以这个没法用

网易云跟帖：这个是目前自己用的，效果也很好，主要是并不需要备案。

4、分享

百度分享：是目前所用的，目前自己用尚存在一个问题并没有解决：安装并成功分享之后，百度分享后台并没有获取到数据。。。

5、404公益页面

一般的404页面没什么特色，偶然看到别人网站上404页面显示的是腾讯寻找丢失儿童的公益广告，感觉这个挺不错的，就借鉴过来用了；

至于用法就是把下面代码复制到博客目录下 404.html 文件中。可自行修改主页信息和链接。

Q&A(持续更新)

错误是无法避免，我们能做的就是正视它。

使用过程中遇到任何问题，可以联系我，或者在下面留言，我会尽力去解决，并在下面记录，或者你遇到了问题你自己已经解决也可以告诉我，目的就是为了让更多的人少走弯路。

1、gem install jekyll 命令出错

$ sudo gem install jekyll

ERROR: While executing gem ... (OpenSSL::SSL::SSLError)

hostname "upyun.gems.ruby-china.org" does not match the server certificate

原因：可能是证书错误或者需要更新Ruby环境(ruby版本必须是2.2以上)

解决证书错误

$ sudo curl -O http://curl.haxx.se/ca/cacert.pem

$ sudo mv cacert.pem cert.pem

更新Ruby环境

0.安装homebrew，已经有了就可以跳过这一步

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

1.安装rvm$ curl -L get.rvm.io | bash -s stable

2.装载rvm$ source ~/.rvm/scripts/rvm

3.安装2.3.0版本ruby$ rvm install 2.3.0

4.将2.3.0设为默认$ rvm use 2.3.0 --default

2、本地推送到GitHub出错

$ git push -u origin master

error: src refspec master does not match any.

error: failed to push some refs to 'git@github.com:honeycao/username.github.io.git'

原因：创建远端仓库的时候，添加了一个README.md，本地推送到远端的时候没有README.md，那么需要先 pull 远端代码再进行推送

再或者远端也没有README.md，所以本地需要先新建一个，再进行推送

3、使用我的博客，如果你本机没有任何jekyll环境，可能会报错

/Users/xxxxxxxx/.rvm/rubies/ruby-2.2.2/lib/ruby/site_ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:in `require': cannot load such file -- bundler (LoadError)

from /Users/xxxxxxxx/.rvm/rubies/ruby-2.2.2/lib/ruby/site_ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:in `require'

from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/gems/jekyll-3.3.0/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'

from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/gems/jekyll-3.3.0/exe/jekyll:9:in `'

from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/jekyll:23:in `load'

from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/jekyll:23:in `'

from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/ruby_executable_hooks:15:in `eval'

from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/ruby_executable_hooks:15:in `'

原因：可能就是没有安装 bundler，执行安装bundler 命名

$ gem install bundler

成功之后再次执行jekyll serve，有一个新的错误提示

Could not find proper version of jekyll (3.1.1) in any of the sources

Run `bundle install` to install missing gems.

根据提示进行操作即可

$ bundle install