經過GitHub Pages創建我的站點（詳細步驟）

$ git clone https://github.com/USERNAME/PROJECT.git PROJECT

$ git checkout --orphan gh-pages

$ git rm -rf .

$ git add .

$ git commit -a -m "First pages commit"

$ git push origin gh-pages

3. 能夠經過User/Organization Pages創建主站，而經過Project Pages掛載二級應用頁面。

3.3 建立步驟

第一步：建立我的站點

第二步：設置站點主題

進入資源-setting

更新你的站點

選擇主題併發布

3.4 經常使用命令

$ git clone git@github.com:username/username.github.com.git //本地若是無遠程代碼，先作這步，否則就忽略

$ cd .ssh/username.github.com //定位到你blog的目錄下

$ git pull origin master //先同步遠程文件，後面的參數會自動鏈接你遠程的文件

$ git status //查看本地本身修改了多少文件

$ git add . //添加遠程不存在的git文件

$ git commit * -m "what I want told to someone"

$ git push origin master //更新到遠程服務器上

4 使用Jekyll搭建博客

4.1 什麼是jekyll

Jekyll是一種簡單的、適用於博客的、靜態網站生成引擎。它使用一個模板目錄做爲網站佈局的基礎框架，支持Markdown、Textile等標記語言的解析，提供了模板、變量、插件等功能，最終生成一個完整的靜態Web站點。說白了就是，只要安裝Jekyll的規範和結構，不用寫html，就能夠生成網站。[jekyll介紹][jekyll on github][jekyllbootstrap]。

Jekyll使用Liquid模板語言，{{page.title}}表示文章標題，{{content}}表示文章內容。咱們能夠用兩種Liquid標記語言：輸出標記（output markup）和標籤標記 (tag markup)。輸出標記會輸出文本（若是被引用的變量存在），而標籤標記不會。輸出標記是用雙花括號分隔，而標籤標記是用花括號-百分號對分隔。[Liquid模板語言] [Liquid模板變量參考]。

jekyll與github的關係：GitHub Pages一個由 GitHub 提供的用於託管項目主頁或博客的服務，jekyll是後臺所運行的引擎。

4.2 jekyll本地環境搭建

1. 下載最新的RubyInstaller並安裝(我下載的是rubyinstaller-1.9.3-p194.exe)，設置環境變量，path中配置C:\Ruby193\bin目錄，而後在命令行終端下輸入gem update --system來升級gem；

2. 下載最新的DevKit，DevKit是windows平臺下編譯和使用本地C/C++擴展包的工具。它就是用來模擬Linux平臺下的make,gcc,sh來進行編譯。可是這個方法目前僅支持經過RubyInstaller安裝的Ruby，並雙擊運行解壓到C:\DevKit。而後打開終端cmd，輸入下列命令進行安裝：

cd C:\DevKit

ruby dk.rb init

ruby dk.rb install

3. 完成上面的準備就能夠安裝Jekyll了,由於Jekyll是用Ruby編寫的,最好的安裝方式是經過RubyGems(gem):

gem install Jekyll

並使用命令檢驗是否安裝成功

jekyll --version

4. 安裝Rdiscount，這個用來解析Markdown標記的包，使用以下命令：

gem install rdiscount

5. 運行本地工程：

cd 到工程目錄，啓動服務：

jekyll --server

4.3 jekyll目錄結構

_posts： _posts中的數據文檔，經過注入_layouts定義的模板，經過jekyll --server最終生成的靜態頁面在_sites目錄。目錄是用來存放你的文章的，通常以日期的形式書寫標題。
_layouts：_layouts中的模板通常指向了_includes/themes中的模板。目錄是用來存放模板的，在這裏你能夠定義頁面中不一樣的頭部和底部。
_includes：

1) _includes/JB中有一些經常使用的工具，用於列表顯示、評論等；

2) _includes/themes中可參看主題的相關html文檔。

3) _includes/themes中的主題通常包含default.html、post.html和page.html三個文檔。default.html定義了網站的最上層框架（模板），post.html和page.html是其子框架（模板）。

4) 生成好的html子頁面經過default.html的{{ content }}變量調用，生成整個頁面。

assets 渲染頁面的CSS和JS文檔在assets/themes中
_config.yml 站點生成須要用到_config.yml配置文件，站點的全局變量在_config.yml中定義，用site.訪問；頁面的變量在YAML Front Matter中定義，用page.訪問，更多的模板變量可參考模板數據。
index.html是你的頁面首頁。

4.4 Jekyll-Bootstrap建立博客

1. 建立我的站點，即建立一個新資源，格式爲username.github.com；

2. 安裝Jekyll-Bootstrap：

$ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com

$ cd USERNAME.github.com

$ git remote set-url origin git@github.com:USERNAME/USERNAME.github.com.git

$ git push origin master

3. 訪問建立好的我的站點：username.github.com

4. 在本地測試查看效果：

cd USERNAME.github.com

jekyll --server

4.5 Jekyll 寫博過程

一、配置 _config.yml：

1) 修改標題：title : My Blog =)

2) 修改我的信息：

author :

name : Name Lastname

email : blah@email.test

github : username

twitter : username

feedburner : feedname

3) 引用：_config.yml中的鍵值均引用到其餘頁面{{ site.title }}；

二、 寫文章

按照_config.yml的格式permalink: /:categories/:year/:month/:day/:title，能夠修改格式，建立markdown格式文件，就能夠當初博客發佈了。

三、發佈

本地預覽修改：運行jekyll –server，預覽http:127.0.0.1:4000。

發佈到github上：經過命令提交或者客戶端提交。

4.6 個性化博客

Github Page完成了博客的主要功能，寫做、發佈、修改，這些都是相對靜態的東西，就是你本身能夠控制的事情，還有一些動態的東西Github Pages沒法支持，好比說文章瀏覽次數、文章的評論等，還有一些個性化的東西，像個性化頁頭頁尾、代碼高亮能夠把博客整的更漂亮一點，其實這寫均可以經過第三方應用來實現，個性化本身的博客。

加上Disqus雲評論:

註冊http://disqus.com/

修改_config.yml:

comments :

provider : disqus

disqus :

short_name : tiansj

5 使用Markdown

5.1 簡介

Markdown 的宗旨是實現「易讀易寫」。可讀性，不管如何，都是最重要的。

Markdown 的語法全由一些符號所組成，這些符號通過精挑細選，其做用一目瞭然。格式撰寫的文件能夠直接以純文本發佈，而且看起來不會像是由許多標籤或是格式指令所構成。

資料：[搭建環境]

5.2 基本語法

使用一個或多個空行分隔內容段來生成段落 <p>。
標題（h1~h6）格式爲使用相應個數的「#」做前綴，好比如下代碼表示 h3：

### this is a level-3 header ###

使用「>」做爲段落前綴來標識引用文字段落。這實際上是 email 中標記引用文字的標準方式：

> 引用的內容

> 這個記號直接借鑑的郵件標準

使用「*」「+」「-」來表示無序列表；使用數字加「.」表示有序列表。如：

1. I am ordered list item 1...

2. So I should be item 2!?

使用 4 個以上空格或 1 個以上的 tab 來標記代碼段落，它們將被<pre> 和 <code> 包裹，這意味着代碼段內的字體會是 monospace家族的，而且特殊符號不會被轉義。
使用 [test](http://example.net "optional title") 來標記普通連接。
使用 ![img](http://example.net/img.png "optional title") 來標記圖片。

引號內的 title 文字是可選的，連接也可使用相對路徑。