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源碼解讀視頻》
------------------------------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------------------