用jekyll和github Pages寫博客

題外話，在當今這個微博都還沒來得及高興一下就被朋友圈拉下神壇的年代，說如何搭建本身的博客系統彷佛已經太過於過期了。 若是你有這樣的想法，恐怕這篇文章不是很是適合你了。建議你把它關了去刷朋友圈。若是你和我同樣，仍是願意折騰，而且願意將折騰記錄下來。那麼，咱們交個朋友吧。一塊兒去刷朋友圈。

工欲善其事，必先利其器。介紹一下咱們要用到的兩個工具。 首先登場的是：github pages是github提供的，免費的，相似於網頁空間，同樣的一種服務，每一個帳號和每一個項目均可以對應一個pages站點。 今天的另外一個主角叫jekyll是一個用ruby寫的，開源在github上的將純文本文件轉換成靜態博客網站的一個工具。

其實，有了github pages你就徹底能夠想怎麼玩就怎麼玩了。由於他就是一個網頁空間。將html文件扔上去就好了。下面咱們一步一步看如何配置你的github pages。咱們要作的是我的博客，固然是帳號級別的比較好。

第一步，固然是要在github裏創建一個倉庫。注意：這個倉庫的名字特別重要，須要這種格式：你的用戶名.github.io， 好比我，就是laichendong.github.io

第二步，將這個倉庫克隆到本地。

~ $ git clone https://github.com/username/username.github.io

第三步，寫一個hello world到你的博客裏。

~ $ cd username.github.io
~ $ echo "Hello World" > index.html

第四步，提交，推到遠端。

~ $ git add --all
~ $ git commit -m "Initial commit"
~ $ git push -u origin master

第五步，沒有第五步了。瀏覽器裏訪問一下：http://username.github.io

到這裏，你已經擁有了一個你本身的博客站點。想寫什麼就寫什麼了！可是，開什麼玩笑！我來是想些博客的。不是想來作網站的！這個時候就該jekyll上場了。

第一步，安裝jekyll

~ $ gem install jekyll

很悲催的是，國內的網絡環境可能致使你在這一步就失敗了。因而，咱們求助於萬能的淘寶，http://ruby.taobao.org/是淘寶搭建的ruby gems鏡像。感謝！ 換源：

~ $ gem sources --remove https://rubygems.org/
~ $ gem sources -a https://ruby.taobao.org/
~ $ gem sources -l
	*** CURRENT SOURCES ***
	https://ruby.taobao.org

這時候再運行安裝命令應該就沒問題了。

第二步，新建一個博客

~ $ jekyll new myblog

第三步，運行博客服務器

~ $ cd myblog
~/myblog $ jekyll serve

這時候你你再瀏覽器裏敲http://localhost:4000就能看到效果了。

雖然在瀏覽器裏你看到了一個頁面，但你可能還有點蒙。咱們回到myblog文件夾裏看看，都是怎麼回事兒。文件夾裏的目錄大概應該像這樣，不徹底同樣也別大驚小怪。都是些一看就懂的東西

.
├── _config.yml // 博客配置文件
├── _drafts // 博客草稿
|   ├── begin-with-the-crazy-ideas.textile
|   └── on-simplicity-in-technology.markdown
├── _includes // 包含文件，公共頭尾什麼的
|   ├── footer.html
|   └── header.html
├── _layouts // 佈局文件，用來組裝頁面架子的
|   ├── default.html
|   └── post.html
├── _posts // 你的博客原文
|   ├── 2007-10-29-why-every-programmer-should-play-nethack.textile
|   └── 2009-04-26-barcamp-boston-4-roundup.textile
├── _site // 最終生成的博客站點
├── .jekyll-metadata // jekyll本身用的一些元數據，最好別把它放到git裏區管理
└── index.html // 這個你懂的拉

假如你新寫了一篇文章在_posts裏。先運行一下build在server就能看到了。

~ $ jekyll build
~ $ jekyll s

你不會想問我，怎麼將jekyll生成的網站弄到github pages上去吧？額，很簡單。把整個目錄 注意是整個目錄，包括源文件配置文件等等，都扔到你的username.github.io這個倉庫裏去就好了。github pages能自動識別出來 _site 下才是你的站點。真是太tmd貼心了！

若是你看到這了都還沒放棄，說明咱們已是朋友了。 就再說兩招吧：

一，沒事兒多看官網的文檔。這纔是王道。英文頭疼的話，jekyll還有好心人翻譯了中文的：http://jekyllcn.com/

二，若是你像我同樣，有本身的域名，切不喜歡github.io的二級域名的話，也能夠配置解析，讓github pages用本身的域名

第一步是在你的倉庫裏創建一個CNAME文件。這個文件裏就寫你的域名就好了，好比laichendong.com，別有別的了。若是正確設置了CNAME文件，在你的倉庫設置頁面，應該能看到這樣一行字。

 Your site is published at http://laichendong.com

第二步就是將你的域名解析指向到你的github給你的二級域名上就ok了。

器已經善了，工纔是王道。博客已經搭建起來了，裏面的博文才是最重要的。願你記錄非凡人生。