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原始碼解讀視訊》
------------------------------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------------------