使用 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:   -- :: +
categories: share
---

写完这几行之后，剩下的就可以自己轻松愉快的写markdown了。是不是很简单？

运行jekyll serve，即可在任何时候通过浏览器及时查看效果。待文章写完并查看效果没问题之后，即可push到github上，这样就OK了。

总结

建议大家都弄一个个人站点，很简单也很方便，提升bi格、形象的同时，也为自己积累平时的知识。

 

 

欢迎访问个人博客中的该文章：http://wangfupeng1988.github.io/share/2016/07/24/github-jekyll-blog.html

-------------------------------------------------------------------------------------------------------------

欢迎关注我的教程：

《使用grunt搭建全自动web前端开发环境》《json2.js源码解读视频》

《深入理解javascript原型和闭包系列》《css知多少》《微软petshop4.0源码解读视频》

------------------------------------------------------------------------------------------------------------

wangEditor，轻量化web富文本编辑器

-------------------------------------------------------------------------------------------------------------