使用 github + jekyll 搭建个人博客
前言
我之前很多文章都是在博客园写的，有兴趣可以到 王福朋-博客园 逛一逛看看，还有一些点赞比较多的，例如《 深入理解javascript原型和闭包 》《 css值多少 》系列文章。但是后来，博客园的访问量感觉就少了很多，而且我在上面推荐自己的 开源项目 开会被下架主页————于是，就慢慢的不怎么写了。
后来想写一下，又找不到合适的平台——现在技术分享的博客平台太多了，眼花缭乱，看不出哪个最好，当然这种情况对于行业来说是好事儿。后来我就不管三七二十一了，自己弄一个算了，爱有人看没人看的吧，反正写文章也都是为了自己一些知识的总结，别人看也不给我钱。
说到这里我很好奇那些有打赏功能的站点，用户真的给打赏吗？反正我是没给过——别说我抠门，我只是还未适应这种获取知识的方式
最后郑重声明，以后我将放弃博客园，在 wangfupeng1988.github.io 写文章！
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格、形象的同时，也为自己积累平时的知识。
正文到此结束
热门推荐
相关文章
Loading...
![[HBLOG]公众号](http://www.liuhaihua.cn/img/qrcode_gzh.jpg)
