使用 github + jekyll 搭建个人博客
github + jekyll
本地写markdown，然后push到github，就成了博客
其实我一早就知道这两者可以搭建个人博客，因为本人有个很好的习惯——每天都会去看看一些热门文章，了解行业最新动态，所以什么新鲜事儿我都知道点，可能不熟悉而已。
于是今晚就试着弄一下，去百度找了几个文章，结果一注意时间（程序员职业病）都是好几年之前的了，我瞬间就怀疑了时效性，因为技术发展太快了。于是就摸着石头过河，果然踩了几个雷。
雷就不说了，这不重要，重要的是总结一下正确的步骤。
创建github帐号和项目
github——俗称全球程序员社交网站（我觉得应该叫全球程序员伸手即得网站）——如果你作为一名程序员竟然没有github帐号，那你看到这篇文章时，就应该自罚三杯牛栏山了——好喝不上头！
登录github站点，然后接下来要做一个重要的事儿————如果你的用户名是gebilaowang，那么你要创建一个名为gebilaowang.github.io的项目，我的用户名是wangfupeng1988，所以我当时创建了名为 wangfupeng1988.github.io 的项目。
什么？你不会创建项目？—— 那你先暂停，先去了解一下github的基本应用
安装 jekyll
首先，本抱歉，我这里只有mac笔记本，windows的安装过程我不清楚，自己个儿查去吧——所谓，你不自己动手、谁闲的教你呀？
我用 mac os 安装 jekyll 算是经历了一点波折。从网上搜的安装过程都是这样的
## 检查gem版本 $ gem -v ## 更新Gem(提示权限) $ gem update --system 安装jekyll(提示权限) $ gem install jekyll 安装成功之后，查看版本号 $ jekyll -v
但是我既然这么说，那肯定这样就是失败的，据说是由于『10.11对系统文件安全进行了更新，所谓的（SIP）』。后来才发现，原来只有默认的安装路径才会有这个权限的问题，那干脆就把路径改了就是了。打印出系统的$PATH然后另外找一个路径安装就是了，这样的好处就是安装完了不用再修改$PATH——否则安装这个也改、安装那个改，时间长了就乱了。
$ echo $PATH /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/git/bin ## 换个路径安装 $ gem install jekyll -n /usr/local/git/bin
还有执行gem update --system的时候可能需要科学(fan)上网(qiang)，这个就得自己想办法了。不过没有购买vpn的同学，我推荐使用Lantern（mac用户），没用过的搜一下。虽然速度慢、有时不行，但毕竟免费的，要啥自行车？
哦 对了，以上安装完了之后呢，最好安装一个rdiscount，据说是解析markdown用的，方法跟安装jekyll一样
gem install rdiscount -n /usr/local/git/bin
初始化博客
上一步，jekyll、rdiscount已经安装成功了。
然后进入你置顶的文章目录，执行以下命令，然后你就能看到jekyll已经为你创建了一些基本的文章。
$ jekyll new gebilaowang_blog $ cd gebilaowang_blog $ ls
这面的文件夹名称、作用都是规定好的，想对他们有简单的了解，还是去看看阮一峰老师的这篇文章吧，我就不再赘述了。但是，这篇文章有些信息已经过时，只准看，不准照着做！
想要看效果，运行
$ jekyll serve $ open http://127.0.0.1:4000/
这时候你会看到运行除了一个基本的页面，但是都是英文。这个没关系，都是应为咱们可以改成中文。
先打开./_config.yml，把里面的信息改成你个人的信息，姓名、邮箱、描述什么的，能改的都改了。然后打开./about.md和./index.html将里面的英文看着能修改的也都修改了。
注意，代码中``和\{\% ... \%\}内容不能修改，这都是变量，不是普通文字。还要注意，每个页面类似如下代码，即有两个---的部分，只能修改，不能删除！
---
layout: page
title: 关于
permalink: /about/
---
好，全部改完之后，重新运行jekyll serve，刷新页面，即可看到效果了。
你说，刚才改英文改的是模板和个人信息的，但是博客内容怎么办？我怎么写博客呀？—— 别急，饭得一口一口吃
提交到github
运行jekyll serve通过浏览器本地查看没问题之后，可以提交到github了。提交之前，要创建一个.gitignore文件，编写如下内容（表示./_site文件夹及其内容无需提交到远程，因为它本地临时文件，github不需要它）
_site/*
提交过程就简单写一下了，不再赘述，都是git的常用知识。看以前的文章说非得建一个gh-pages分支，但是经过我验证，不需要。
$ git init $ git add . $ git commit -m "init blog" $ git remote add origin xxxxxxx（拷贝github的地址）xxxxxxx.git $ git push origin master
好了，然后你浏览器访问gebilaowang.github.io试试（假如github用户名是gebilaowang），是否看到效果了？
写文章
有两个规定先记下：
- 文章必须新建在
./_posts文件夹中 - 文章名称必须是
yyyy-mm-dd-xxxxx-xxx-xxx格式，后缀名可以是.markdown | .html | .textile（但我只推荐markdown形式，因为易学、通用、效率高）
例如，我写这篇文章，我就要新建一个./_posts/2016-07-24-github-jekyll-blog.markdown的文件，此时你们应该可以在这里看到这个文件及其源码。
开始编写博客源码。
一开始要这样写，下面的内容中，layout: post不能修改，其他的可自行修改。
--- layout: post title: "使用 github + jekyll 搭建个人博客" date: 2016-07-24 21:41:45 +0800 categories: share ---
写完这几行之后，剩下的就可以自己轻松愉快的写markdown了。是不是很简单？
运行jekyll serve，即可在任何时候通过浏览器及时查看效果。待文章写完并查看效果没问题之后，即可push到github上，这样就OK了。
总结
建议大家都弄一个个人站点，很简单也很方便，提升bi格、形象的同时，也为自己积累平时的知识。
-------------------------------------------------------------------------------------------------------------
欢迎关注我的教程：
《使用grunt搭建全自动web前端开发环境》《json2.js源码解读视频》
《深入理解javascript原型和闭包系列》《css知多少》《微软petshop4.0源码解读视频》
------------------------------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------------------
