[原]通過GitHub Pages建立個人站點（詳細(xì)步驟）1 Git簡介2 為什么使用Github Pages3 創(chuàng)建Github Pages3.1 安裝git工具.3.2 兩種pages模式3.3

[原]通過GitHub Pages建立個人站點（詳細(xì)步驟）

1 Git簡介

2 為什么使用Github Pages

3 創(chuàng)建Github Pages

3.1 安裝git工具.

3.2 兩種pages模式

3.3 創(chuàng)建步驟

3.4 常用命令

4 使用Jekyll搭建博客

4.1 什么是jekyll

4.2 jekyll本地環(huán)境搭建

4.3 jekyll目錄結(jié)構(gòu)

4.4 Jekyll-Bootstrap創(chuàng)建博客

4.5 Jekyll 寫博過程

4.6 個性化博客

5 使用Markdown

5.1 簡介

5.2 基本語法

5.3 Notepad 支持Markdown語法高亮

1 Git簡介

Git是一個開源的分布式版本控制系統(tǒng)，用以有效、高速的處理從很小到非常大的項目版本管理。GitHub可以托管各種git庫的站點。

GitHub Pages免費(fèi)的靜態(tài)站點，三個特點：免費(fèi)托管、自帶主題、支持自制頁面和Jekyll。2 為什么使用Github Pages

1. 搭建簡單而且免費(fèi)；

2. 支持靜態(tài)腳本；

3. 可以綁定你的域名；

4. DIY自由發(fā)揮，動手實踐一些有意思的東西git,markdown,bootstrap,jekyll；

5. 理想寫博環(huán)境，git github markdown jekyll；

3 創(chuàng)建Github Pages

3.1 安裝git工具

3.2 兩種pages模式

1. User/Organization Pages 個人或公司站點

1) 使用自己的用戶名，每個用戶名下面只能建立一個；

2) 資源命名必須符合這樣的規(guī)則username/username.github.com；

3) 主干上內(nèi)容被用來構(gòu)建和發(fā)布頁面

2. Project Pages 項目站點

1) gh-pages分支用于構(gòu)建和發(fā)布；

2) 如果user/org pages使用了獨立域名，那么托管在賬戶下的所有project pages將使用相同的域名進(jìn)行重定向，除非project pages使用了自己

的獨立域名；

3) 如果沒有使用獨立域名，project pages將通過子路徑的形式提供服務(wù)username.github.com/projectname；

4) 自定義404頁面只能在獨立域名下使用，否則會使用User Pages 404；

5) 創(chuàng)建項目站點步驟：

$ 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掛載二級應(yīng)用頁面。

3.3 創(chuàng)建步驟

第一步：創(chuàng)建個人站點

第二步：設(shè)置站點主題

進(jìn)入資源-setting

更新你的站點

選擇主題并發(fā)布

3.4 常用命令

$ git clonegit@github.com:username/username.github.com.git//本地如果無遠(yuǎn)程代碼，先做這步，不然就忽略

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

$ git pull origin master //先同步遠(yuǎn)程文件，后面的參數(shù)會自動連接你遠(yuǎn)程的文件

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

$ git add . //添加遠(yuǎn)程不存在的git文件

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

$ git push origin master //更新到遠(yuǎn)程服務(wù)器上

4 使用Jekyll搭建博客

4.1 什么是jekyll

Jekyll是一種簡單的、適用于博客的、靜態(tài)網(wǎng)站生成引擎。它使用一個模板目錄作為網(wǎng)站布局的基礎(chǔ)框架，支持Markdown、Textile等標(biāo)記語言的解析，提供了模板、變量、插件等功能，最終生成一個完整的靜態(tài)Web站點。說白了就是，只要安裝Jekyll的規(guī)范和結(jié)構(gòu)，不用寫html，就可以生成網(wǎng)站。[jekyll介紹 ][jekyll on github ][jekyllbootstrap ]。

Jekyll使用Liquid模板語言，{{page.title}}表示文章標(biāo)題，{{content}}表示文章內(nèi)容。我們可以用兩種Liquid標(biāo)記語言：輸出標(biāo)記（output

markup）和標(biāo)簽標(biāo)記 (tag markup)。輸出標(biāo)記會輸出文本（如果被引用的變量存在），而標(biāo)簽標(biāo)記不會。輸出標(biāo)記是用雙花括號分隔，而標(biāo)簽標(biāo)記是用花括號-百分號對分隔。[Liquid模板語言 ] [Liquid模板變量參考 ]。

jekyll與github的關(guān)系：GitHub Pages一個由 GitHub 提供的用于托管項目主頁或博客的服務(wù)，jekyll是后臺所運(yùn)行的引擎。

4.2 jekyll本地環(huán)境搭建

1. 下載最新的RubyInstaller 并安裝(我下載的是rubyinstaller-1.9.3-p194.exe )，設(shè)置環(huán)境變量，path中配置C:Ruby193bin目錄，然后在命令行終端下輸入gem update --system來升級gem；

2. 下載最新的DevKit ，DevKit是windows平臺下編譯和使用本地C/C 擴(kuò)展包的工具。它就是用來模擬Linux平臺下的make,gcc,sh來進(jìn)行編譯。但是這個方法目前僅支持通過RubyInstaller安裝的Ruby，并雙擊運(yùn)行解壓到C:?vKit。然后打開終端cmd，輸入下列命令進(jìn)行安裝：

cd C:?vKit

ruby dk.rb init

ruby dk.rb install

3. 完成上面的準(zhǔn)備就可以安裝Jekyll了,因為Jekyll是用Ruby編寫的,最好的安裝方式是通過RubyGems(gem):

gem install Jekyll

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

jekyll --version

4. 安裝Rdiscount，這個用來解析Markdown標(biāo)記的包，使用如下命令：

gem install rdiscount

5. 運(yùn)行本地工程：

cd 到工程目錄，啟動服務(wù)：

jekyll --server