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

[原]通過(guò)GitHub Pages建立個(gè)人站點(diǎn)（詳細(xì)步驟）

1 Git簡(jiǎn)介

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 寫(xiě)博過(guò)程

4.6 個(gè)性化博客

5 使用Markdown

5.1 簡(jiǎn)介

5.2 基本語(yǔ)法

5.3 Notepad 支持Markdown語(yǔ)法高亮

1 Git簡(jiǎn)介

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

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

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

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

3. 可以綁定你的域名；

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

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

3 創(chuàng)建Github Pages

3.1 安裝git工具

3.2 兩種pages模式

1. User/Organization Pages 個(gè)人或公司站點(diǎn)

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

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

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

2. Project Pages 項(xiàng)目站點(diǎn)

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

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

的獨(dú)立域名；

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

4) 自定義404頁(yè)面只能在獨(dú)立域名下使用，否則會(huì)使用User Pages 404；

5) 創(chuàng)建項(xiàng)目站點(diǎn)步驟：

$ 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. 可以通過(guò)User/Organization Pages建立主站，而通過(guò)Project Pages掛載二級(jí)應(yīng)用頁(yè)面。

3.3 創(chuàng)建步驟

第一步：創(chuàng)建個(gè)人站點(diǎn)

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

進(jìn)入資源-setting

更新你的站點(diǎn)

選擇主題并發(fā)布

3.4 常用命令

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

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

$ git pull origin master //先同步遠(yuǎn)程文件，后面的參數(shù)會(huì)自動(dòng)連接你遠(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是一種簡(jiǎn)單的、適用于博客的、靜態(tài)網(wǎng)站生成引擎。它使用一個(gè)模板目錄作為網(wǎng)站布局的基礎(chǔ)框架，支持Markdown、Textile等標(biāo)記語(yǔ)言的解析，提供了模板、變量、插件等功能，最終生成一個(gè)完整的靜態(tài)Web站點(diǎn)。說(shuō)白了就是，只要安裝Jekyll的規(guī)范和結(jié)構(gòu)，不用寫(xiě)html，就可以生成網(wǎng)站。[jekyll介紹 ][jekyll on github ][jekyllbootstrap ]。

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

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

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

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

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

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

cd C:?vKit

ruby dk.rb init

ruby dk.rb install

3. 完成上面的準(zhǔn)備就可以安裝Jekyll了,因?yàn)镴ekyll是用Ruby編寫(xiě)的,最好的安裝方式是通過(guò)RubyGems(gem):

gem install Jekyll

并使用命令檢驗(yàn)是否安裝成功

jekyll --version

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

gem install rdiscount

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

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

jekyll --server