2016年12月30日16:28:35
該文章已經(jīng)有些久遠穆咐。隨著各自軟件的更新迭代，目前安裝jekyll以及構建博客相對更加簡單灾常。這篇文章只是希望能作個參考照激，能幫到您當然最好发魄。以及如果看客您感覺這個文章不是太合適的話，還請不要太在意細節(jié)俩垃。
文章主題目錄：
- 構建github個人博客庫：username.github.io
- 安裝jekyll相關內(nèi)容
- 修改configuration file以及建立自己的對應網(wǎng)頁
- 安裝相關插件励幼，比如markdown解析包、代碼高亮包pygments口柳、mathjax相關修改等苹粟，以讓博客支持自己的大多數(shù)寫作需求
- 本地編譯預覽，沒有問題后上傳至github
1. 構建github個人博客庫：username.github.io
不管怎么樣去建立這個博客跃闹，首先必須在 github 上有這樣的一個庫嵌削，其名稱為 username.github.io，username就是每個github用戶的用戶ID望艺，只有這樣名稱的庫才能被github用于鏈接到個人博客苛秕。
鏈接的代碼就是:
git remote set-url origin git@github.com:*******/********.github.io.git
2. 安裝jekyll相關內(nèi)容
jekyll 是 Ruby 的一個gem包。安裝稍顯繁瑣找默，主要順序如下：
2.1 下載安裝ruby
這里下載的ruby版本為1.9.3艇劫，由于大陸墻掉了官方給的Ruby下載網(wǎng)址，所以百度這個版本的下載即可惩激。注意安裝路徑不能包含中文和空格店煞，就 c://ruby 蠻好。
2.2 安裝 Devkit for Ruby 1.9.3
可到此處下載风钻。并且在cmd.exe中運行如下代碼：
cd devkit // 目的是將當前目錄轉移到devkit解壓路徑
ruby dk.rb init
ruby dk.rb install
P.S. 安裝過程中記得全部勾選 add to the path顷蟀，將其位置添加到系統(tǒng)變量中，并且在安裝完成后骡技，使用如下代碼查詢安裝版本號確認安裝成功(顯示版本號即為安裝成功)：
ruby -v
2.3 安裝 gem 以及 jekyll 包
https://ruby.taobao.org/
到gem下載合適的gem安裝包并安裝鸣个，注意點同上。同時記得這個網(wǎng)站布朦，里面包括了所有的gem功能包毛萌，很好狠強大；
安裝完gem后也記得查看版本號以及安裝完成狀態(tài)喝滞。
然后安裝 jekyll,通過
gem install jekyll // 安裝jekyll
gem install kramdown // markdown語言解析包
gem install pygments.rb // 代碼高亮包
gem install liquid // 這個包我不知道阁将，但是好像有用
// 還有些別的包，看需要來安裝啦
其中右遭，高亮包需要python2.6或2.7的環(huán)境做盅，因此還需要安裝python，所幸在使用某些gem包的時候窘哈，可能會出現(xiàn) Application runtime error的問題吹榴，這個時候也需要安裝 Node.js 來提供一個使用環(huán)境（maybe），也需要安裝python滚婉，因此就早點安裝了更好图筹。
3. 修改configuration file以及建立自己的對應網(wǎng)頁
完成上述操作后，就可以進入博客的成型步驟了。首先需要建立自己的文件檔案远剩，也就是博客的硬件來源扣溺。有兩種方案：
3.1 自己建立
可以自己通過如下代碼建立，會在當前目錄下產(chǎn)生一個jekyll默認模板文件夾瓜晤，里面包含了主要的文件內(nèi)容锥余，將其整體拷貝到自己的倉庫中即可。
jekyll new (name)
3.2 fork別人
但是更好的方式可能是這種痢掠，因為建立一個漂亮的博客是每一個bloger最希望的事驱犹，但是可能剛開始入手會有點難，從0開始的話需要安裝主題足画、自己做前段開發(fā)是件很考驗編程水平和藝術水平的事雄驹，不妨可以在剛開始接觸的時候先套用別人的模板，等自己對大致使用方法和流程了解后淹辞，再在其基礎上或自己從0開始構建自己心中最完美的博客医舆。
網(wǎng)上有很多牛人提供了漂亮的主題以及博客模板，因此可以通過github fork桑涎，然后將名字改為自己的username.github.io彬向；然后clone到本地（注意路徑不能包含中文，因為jekyll在建立運行時對中文不識別導致不成功）攻冷。
3.3 修改相應文件建立自己的blog
庫中所包含的主要文件及文件夾有：
- 文件夾_layouts：用于存放模板的文件夾娃胆，
- 文件夾_posts：用于存放博客文章的文件夾
- 文件夾css：存放博客所用css的文件夾,比如主題文件以及高亮文件都是放在此處的
- .gitignore：可以刪掉，后面會將項目添加到git項目等曼，所以這個不需要了
- _coinfig.yml：jekyll的配置文件里烦，里面可以定義相當多的配置參數(shù)，具體配置參數(shù)可以參照其官網(wǎng)
- index.html：項目的首頁
- _includes:用于存放一些固定的HTML代碼段禁谦，文件為.html格式胁黑，可以在模板中通過liquid標簽引入，常用來在各個模板中復用如 導航條州泊、標簽欄丧蘸、側邊欄之類的在每個頁面上都一樣不變的內(nèi)容，需要注意的是遥皂，這個代碼段也可以是未被編譯的力喷，也就是說也可以使用liquid標簽放在這些代碼段中
通過修改配置文件_coinfig.yml以及post和layouts就可以實現(xiàn)主要blog的建立和修改。
4. 安裝相關插件演训，比如markdown解析包弟孟、代碼高亮包pygments、mathjax相關修改等样悟，以讓博客支持自己的大多數(shù)寫作需求
4.1 markdown解析包 kramdown
通過gem安裝后拂募，需要在配置文件 _coinfig.yml 中添加該項：
markdown: kramdown
kramdown:
input: GFM
4.2 代碼高亮包 pygments
安裝后庭猩，首先需要一個 .css 文件，但是我也不清楚怎么在windows下生成這個文件陈症，也就是從網(wǎng)上找到的一個蔼水，且其來源為此，并且名字成為 highlight.css爬凑，存放目錄為 ./assets/css以及./_site/assets/css兩個文件夾徙缴，然后同樣需要在配置文件中做如下修改：
highlight: true
并且需要對樣式進行鏈接试伙，需要修改生成網(wǎng)頁的模板或通用頭文件嘁信，進入本地庫目錄 ./_includes/header.html,然后添加下句：
<link rel="stylesheet" href="/assets/css/highlight.css">
//其中 /assets/css/ 為該文件所在位置
在使用代碼時，需要在符合markdown的語法基礎上疏叨，在代碼主體前后添加兩句話潘靖，舉例如下：
{% highlight c++ linenos %}
{
cout<<endl;
cout<<"HAHAHA"<<endl;
cout<<"I am Hahaha"<<endl;
}
{% endhighlight %}
4.3 使用mathjax呈現(xiàn)公式
雖然kramdown是支持mathjax語法的，但是為了使網(wǎng)頁可以使用mathjax蚤蔓，還需要作如下修改卦溢，可參考此處，同樣到庫 ./_includes/header.html秀又，添加如下語句单寂，有的文章里面給出的添加內(nèi)容沒有這么多，但是多多益善吧吐辙，僅僅信之宣决。
5. 本地編譯預覽，沒有問題后上傳至github
5.1 本地編譯預覽
使用命令建立并在當?shù)乜深A覽當前的網(wǎng)頁狀態(tài)昏苏，網(wǎng)址為：http://localhost:4000/ 尊沸，如果有問題則繼續(xù)修改，沒有就可以進行下一步了贤惯。
jekyll build
jekyll serve
5.2 通過github將本地庫的改動提交到網(wǎng)上
所使用的命令為：
git add . // 如果沒有新加文件可以不用運行此句
git commit -am '描述內(nèi)容'
git push (-u origin master) // 括號中內(nèi)容可加可不加
如果沒有提示錯誤的話洼专，一切順利，就可以去網(wǎng)站：http://username.github.io 查看屬于自己的個人博客啦孵构！~~
