Jekyll搭建我的博客

　以前写了一篇 HEXO搭建我的博客 的教程得到了很好评，尤为是在 简书 上目前已经累积了10W+的阅读量了，也有好心的读者主动给我打赏，在此感谢。

　若是你看过个人文章会发现我如今的博客样式跟以前是有很大的区别的，以前我也是使用 HEXO 搭建的博客，后来发现使用 HEXO 在多台电脑上发布博客，操做起来并非那么方便，果断就转到了 Jekyll 上，接下来我会讲如何使用 Jekyll 搭建博客，博客模板效果。

介绍

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

　使用 Jekyll 搭建博客以前要确认下本机环境，Git 环境（用于部署到远端）、Ruby 环境（Jekyll 是基于 Ruby 开发的）、包管理器 RubyGems
　　若是你是 Mac 用户，你就须要安装 Xcode 和 Command-Line Tools了。下载方式 Preferences → Downloads → Components。

　　Jekyll 是一个免费的简单静态网页生成工具，能够配合第三方服务例如： Disqus（评论）、多说(评论) 以及分享 等等扩展功能，Jekyll 能够直接部署在 Github（国外） 或 Coding（国内） 上，能够绑定本身的域名。Jekyll中文文档、Jekyll英文文档、Jekyll主题列表。

Jekyll 环境配置

安装 jekyll

$ gem install jekyll

建立博客

$ jekyll new myBlog

进入博客目录

$ cd myBlog

启动本地服务

$ jekyll serve

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

so easy !

目录结构

　
　Jekyll 的核心实际上是一个文本转换引擎。它的概念其实就是： 你用你最喜欢的标记语言来写文章，能够是 Markdown，也能够是 Textile,或者就是简单的 HTML, 而后 Jekyll 就会帮你套入一个或一系列的布局中。在整个过程当中你能够设置URL路径, 你的文本在布局中的显示样式等等。这些均可以经过纯文本编辑来实现，最终生成的静态页面就是你的成品了。

一个基本的 Jekyll 网站的目录结构通常是像这样的：

.
├── _config.yml
├── _includes
|   ├── footer.html
|   └── header.html
├── _layouts
|   ├── default.html
|   ├── post.html
|   └── page.html
├── _posts
|   └── 2016-10-08-welcome-to-jekyll.markdown
├── _sass
|   ├── _base.scss
|   ├── _layout.scss
|   └── _syntax-highlighting.scss
├── about.md
├── css
|   └── main.scss
├── feed.xml
└── index.html

这些目录结构以及具体的做用能够参考 官网文档

进入 _config.yml 里面，修改为你想看到的信息，从新 jekyll server ，刷新浏览器就能够看到你刚刚修改的信息了。

到此，博客初步搭建算是完成了，

博客部署到远端

　我这里讲的是部署到 Github Page 建立一个 github 帐号，而后建立一个跟你帐户名同样的仓库，如个人 github 帐户名叫 leopardpan，个人 github 仓库名就叫 leopardpan.github.io，建立好了以后，把刚才创建的 myBlog 项目 push 到 username.github.io仓库里去（username指的是你的github用户名），检查你远端仓库已经跟你本地 myBlog 同步了，而后你在浏览器里输入 username.github.io ，就能够访问你的博客了。

编写文章

　　全部的文章都是 _posts 目录下面，文章格式为 mardown 格式，文章文件名能够是 .mardown 或者 .md。

　　编写一篇新文章很简单，你能够直接从 _posts/ 目录下复制一份出来 2016-10-16-welcome-to-jekyll副本.markdown ，修更名字为 2016-10-16-article1.markdown ，注意：文章名的格式前面必须为 2016-10-16- ，日期能够修改，但必须为 年-月-日- 格式，后面的 article1 是整个文章的链接 URL，若是文章名为中文，那么文章的链接URL就会变成这样的：http://baixin.io/2015/08/%E6%... ， 因此建议文章名最好是英文的或者阿拉伯数字。 双击 2016-10-16-article1.markdown 打开

---
layout: post
title:  "Welcome to Jekyll!"
date:   2016-10-16 11:29:08 +0800
categories: jekyll update
---

正文...

title: 显示的文章名， 如：title: 个人第一篇文章
date: 显示的文章发布日期，如：date: 2016-10-16
categories: tag标签的分类，如：categories: 随笔

注意：文章头部格式必须为上面的，.... 就是文章的正文内容。

我写文章使用的是 Sublime Text2 编辑器，若是你对 markdown 语法不熟悉的话，能够看看做业部落的教程

使用个人博客模板

虽然博客部署完成了，你会发现博客太简单不是你想要的，若是你喜欢个人模板的话，可使用个人模板。

首先你要获取的我博客，Github项目地址，你能够直接点击下载博客，进去leopardpan.github.io/ 目录下， 使用命令部署本地服务

$ jekyll server

若是你本机没配置过任何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 `<top (required)>'
    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 `<main>'
    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 `<main>'

缘由： 没有安装 bundler ，执行安装 bundler 命令

$ gem install bundler

提示：

Fetching: bundler-1.13.5.gem (100%)
Successfully installed bundler-1.13.5
Parsing documentation for bundler-1.13.5
Installing ri documentation for bundler-1.13.5
Done installing documentation for bundler after 5 seconds
1 gem installed

再次执行 $ jekyll server ，提示

Could not find proper version of jekyll (3.1.1) in any of the sources
Run `bundle install` to install missing gems.

跟着提示运行命令

$ bundle install

这个时候你可能会发现 bundle install 运行卡主不动了。

若是很长时间都没任何提示的话，你能够尝试修改 gem 的 source

$ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/
$ gem sources -l
*** CURRENT SOURCES ***

http://ruby.taobao.org

再次执行命令 $ bundle install，发现开始有动静了

Fetching gem metadata from https://rubygems.org/...........
Fetching version metadata from https://rubygems.org/..
Fetching dependency metadata from https://rubygems.org/.
。。。
Installing jekyll-watch 1.3.1
Installing jekyll 3.1.1
Bundle complete! 3 Gemfile dependencies, 17 gems now installed.
Use `bundle show [gemname]` to see where a bundled gem is installed.

bundler安装完成，后再次启动本地服务

$ jekyll server

继续报错

Configuration file: /Users/tendcloud-Caroline/Desktop/leopardpan.github.io/_config.yml
  Dependency Error: Yikes! It looks like you don't have jekyll-sitemap or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- jekyll-sitemap' If you run into trouble, you can find helpful resources at http://jekyllrb.com/help/! 
jekyll 3.1.1 | Error:  jekyll-sitemap

表示 当前的 jekyll 版本是 3.1.1 ，没法使用 jekyll-sitemap

解决方法有两个

一、打开当前目录下的 _config.yml 文件，把 gems: [jekyll-paginate,jekyll-sitemap] 换成 gems: [jekyll-paginate] ，也就是去掉jekyll-sitemap。

二、升级 jekyll 版本，我当前的是 jekyll 3.1.2 。

修改完成后保存配置，再次执行

$ jekyll server

提示

Configuration file: /Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github/_config.yml
            Source: /Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github
       Destination: /Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
                    done in 0.901 seconds.
 Auto-regeneration: enabled for '/Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github'
Configuration file: /Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github/_config.yml
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

表示本地服务部署成功。

在浏览器输入 127.0.0.1:4000 ， 就能够看到baixin.io博客效果了。

修改为你本身的博客

• 若是你想使用个人模板请把 _posts/ 目录下的文章都去掉。

• 修改 _config.yml 文件里面的内容为你本身的。

而后使用 git push 到你本身的仓库里面去，检查你远端仓库，在浏览器输入 username.github.io 就会发现，你有一个漂亮的主题模板了。

【 若是想修改博客样式殊不知道怎么修改，能够直接在评论里给我提问 】

为何要是用 Jekyll

使用了 Jekyll 你会发现若是你想使用多台电脑发博客都很方便，只要把远端 github 仓库里的博客 clone 下来，写文章后再提交就能够了，Hexo 因为远端提交的是静态网页，全部没法直接写 Markdown 的文章。若是你想看 Hexo 搭建博客，能够看看个人另外一篇 HEXO搭建我的博客 的教程。

若是你在搭建博客遇到问题，能够在 原文博客 的评论里给我提问。

后面会继续介绍，在个人博客基础上，如何修改为你本身喜欢的 Style，欢迎继续关注我博客的更新。