github 怎麼搭建博客？

git checkout --orphan gh-pages 這條命令是什麼意思？運行不了，提示錯誤error: unknown option `orphan"

在我動手用jekyll部署我的博客之前，一直使用godaddy上面的wordpress主頁來部署我的博客kresnik.co。WordPress當然有很多的優點，在我看來我用WordPress主要是為了

• 方便清晰的文件結構

• 可以隨意選用的各種模板和插件

• 相對便宜的部署價格

因為這些優點，所以我想我還會在WordPress官網上繼續保留我的免費博客。

既然這樣，看官想必想問為什麼要換成jekyll來重新部署博客？我簡單的總結了一下：

• 流行又簡潔的MarkDown寫作語法

• 輕量級的網站結構，不再有動態網站的沉重

• 方便的和github pages結合，不僅免費，而且方便

所以對比與WordPress的沉重，jekyll讓你回歸到創作本身，當然如果你喜歡折騰，jekyll也絕對不會讓你失望。推薦下面幾個站點亮一下。

• rusty shutter

• Rasmus Andersson

安裝流程

1. 要用github pages，首先要在github中建立一個基於你的用戶名的repository: 比如說我，就要建立名為kresnikwang.github.io的repo。在以前的github版本中還需要在後台開啟pages的功能，現在系統檢測到這樣的repo名稱之後，會在setting中自動開啟GitHub Pages的功能，如下圖： 這樣之後你就可以把這個repo克隆到本地隨意進行修改了，在這個裡面上傳的網頁就是你的網站的內容了，可以上傳一個index.html試一試，這就是你的網站主頁了。 關於GiuHub的使用，可以看幾個比較好的入門教程：GitHub

2. 之後我們就要在本地部署jekyll，jekyll的原理很簡單。這是一個已經合成好的靜態html網站結構，你用這個結構在username,http://github.io文件夾裡面粘帖好所有文件。再把更新完的本地repo推送到GitHub的master branch裡面，你的網站就更新建設完畢了。 首先你需要ruby來使用本地jekyll。Mac和Linux可以用Terminal配合yum或者brew這樣的包管理器很方便的安裝ruby。Windows下更是方便，可以直接中集成好的Ruby installer來進行安裝，文章里的就是傳送門。

   安裝完ruby，之後就是要安裝RubyGems，gem是一個ruby的包管理系統，可以用gem很方便的在本地安裝ruby應用。

   安裝方法

   //在RubyGems官網上下載壓縮包，解壓到你的本地任意位置
//在Terminal中
cd yourpath to RubyGems //你解壓的位置
ruby setup.rb


3. 有了gem之後安裝jekyll就很容易了，其實用過nodejs和npm的同學應該很熟悉這樣的包安裝，真是這個世界手殘腦殘們的救星。。。。。（樓主不自覺的摸了摸自己快殘了的手） 安裝jekyll，有了gem，直接在Terminal裡面輸入以下代碼：

   $ gem install jekyll


4. 好了，現在你的電腦已經準備完畢了。如果你是想自己搗鼓，可以根據這樣的目錄結構在你的http://username.github.io文件夾下建立以下目錄結構：

   ├── _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

   └── index.html

   你可以一個個依次建立起來，然後在自己編寫一個你想要的博客。

5. 如果你只是個普通用戶，只是想要一個模板然後開始寫自己的博客。那就很容易了，有幾個可以簡單開始的模板。

   • poole/poole · GitHub極簡風格的模板
   • Jekyll Themes jekyll的模板網站，可以找到各式各樣你喜歡的模板。

6. 下載完了模板，可以吧裡面的內容解壓到你自己的網站目錄底下。這時候你可以測試一下：

   $ cd you website path //cd到你的網站目錄下
$ jekyll serve
//一個開發伺服器將會運行在 http://localhost:4000/
//你就能在本地伺服器看到你用模板搭建的網站了


7. 這時候可以看一下jekyll的設置，讓你把模板變成你自己個性化的內容。在網站根目錄下面找到_config.yml,這裡會有幾個比較關鍵的設置： 裡面的permalink 就是你博客文章的目錄結構，可以用pretty來簡單的設置成日期+文章標題.html，也可以用自己喜歡的結構來設置。 記得把encoding 設置成utf-8，這樣有利於中英文雙語的寫作和閱讀。

8. 到這裡你就可以開始寫博客了，所有的文章直接放在_posts文件夾下面，格式就是我們之前提到的markdown文件，默認的格式是.md和.markdown文件。每篇文章的開始處需要使用yml格式來寫明這篇文章的簡單介紹，格式如下：

   ---
author: kresnikwang
comments: true
date: 2015-04-28 17:42:32+00:00
layout: post
title: PHP, Angular JS Development|My Export Quote|農產品出口工具開發
categories:
- Works
- Tech
tags:
- bootstrap
- javascript
- php
- AngularJS
---


   layout就是post，讓jekyll知道你這是一篇post，很直觀。需要注意的是裡面的date，必須按照yml的語法來寫，否則就會出現編譯錯誤。可以只用YYYY-MM-DD來顯示日期，也可以像我一樣在後面加上 HH:MM:SS+00:00 來表示更具體的時間。

9. 到此為止可以開始盡情的寫博客了，用GitHub軟體同步到你的repository裡面，網站上面就可以進行正常的顯示了。如果說要添加一下有用的extra功能的話，評論和相關文章這兩個功能比較多人會關注。 評論我們可以用Disqus國內應該也有類似的網站，到Disqus註冊一個賬號，選擇添加評論區域到自己的網頁，你將會的得到類似的代碼：

   &
&& &

   &
&Related Posts& &

   & & &
   kresnik.co博客搬家告示
   &&05 Jun 2015&&
   &
   & &

   & & &
   Javascript Include Html Page By Jquery
   &&02 Jun 2015&&
   &
   & &

   & & &
   Github設置，強制使用"https://" 來代替 "git://"
   &&31 May 2015&&
   &
   & &

   & &

   你每篇文章下面就會有三個相關文章的鏈接了。

   • 這篇教程就到這裡，有機會我想再寫寫liquid語法製作jekyll模板的內容和從wordpress導入文章到jekyll來的方法。喜歡能有些用處，感謝。