2010-08-26

在介紹之前，先普及一下基礎(chǔ)知識，大鳥們直接跳過。

什么是git

git是一個分布式版本控制工具(DVCS)，不需要服務(wù)端軟件支持(即使在地鐵里也可以正常commit)，Linux內(nèi)核開發(fā)用的版本控制工具就是它。

常用的SVN屬于集中式版本控制工具(CVCS)，需要在服務(wù)端開啟SVN服務(wù)，然后客戶端checkout,commit,update。

更詳細(xì)的介紹請參考維基百科

什么是github

github 的標(biāo)語是："secure source code hosting and collaborative development"。一個基于git的類似google code的代碼倉庫，付費(fèi)版的用戶可以創(chuàng)建私有倉庫，支持多人開發(fā)。很多項(xiàng)目都選擇了github來保存代碼，如"jQuery/reddit/RoR/CakePHP/Redis"等等。

github pages

先說說pages功能，blog就是在pages的基礎(chǔ)上搭建的。如果英文不錯的話，可以直接瀏覽此頁

創(chuàng)建一個用戶的頁面很簡單，假設(shè)你的用戶名為foo

1. 新建一個倉庫(repository)，名稱填"foo.github.com"，創(chuàng)建
2. 在本地新建一個文件夾，假如為foo,在foo里面新建一個index.html頁面，隨便輸入點(diǎn)內(nèi)容
3. `git init` 初始化，`git add .` 把index.html加入到倉庫中，`git commit` 提交修改
4. 添加github的分支 `git remote add origin git@github.com:foo/foo.github.com.git`
5. 提交到github分支 `git push origin master`

過1分鐘左右，瀏覽foo.github.com，就可以看到剛剛創(chuàng)建的index.html文件了。

除了創(chuàng)建用戶頁面，還可以針對每個項(xiàng)目單獨(dú)創(chuàng)建項(xiàng)目的主頁，這不是本文的重點(diǎn)，有興趣的可以瀏覽此頁

創(chuàng)建blog

終于扯到正題上了(-,-)，前面已經(jīng)說過如何創(chuàng)建html頁面，其實(shí)已經(jīng)可以寫博客了，創(chuàng)建一個index.html頁面，在里面列出寫過的文章，點(diǎn)擊標(biāo)題進(jìn)去后又是一個手動創(chuàng)建的html頁。就是太麻煩了，一點(diǎn)都不酷，說不定還會被MM鄙視。

github當(dāng)然知道這個問題，所以他們創(chuàng)建了jekyll模板引擎 。簡單來說，就是你可以用textile 或者markdown語法來寫博客，提交到github后，會自動轉(zhuǎn)換成html。

這里有很多網(wǎng)站/博客，都是基于github的jekyll模板開發(fā)的，如果覺得哪個不錯，可以查看source。

先來看看這個倉庫，里面有一些特殊的文件/文件夾：

_config.yml

存儲了一些設(shè)置，大部分的設(shè)置都可以通過命令行指定，但放到配置文件里更方便些

_layouts

_layouts文件夾存放的是模板文件，文章會被渲染到這些模板里，變量指代的是文章內(nèi)容

_posts

這里就是真正存放博客文章的地方了，文件命名要遵守這種格式:year-month-day-title.markup

_site

這個文件夾是程序生成的，如果本地沒有安裝jekyll的話，是不會有這個文件夾的，如果想要先本地預(yù)覽一下，再提交到github，最好通過.gitignore把這個文件夾排除。

index.html

這個文件也有一個yaml前綴 ，可以指定使用哪個模板，標(biāo)題等等，所有根文件夾下的.html/.htm/.textile/.markdown都會被解析。

other files/folders

上面沒有列出的文件/文件夾都會被jekyll放到_site文件夾下，如css/image/script等等。

jekyll的安裝

參考安裝頁 ，如果使用時提示"liquid requires RubyGems version >= 1.3.7"，可以在這里 下載對應(yīng)的文件，安裝即可。

安裝完之后，為了避免路徑調(diào)用問題，可以在apache/nginx里給對應(yīng)的文件夾(/path/to/_site)綁定一個本地域名，如"lc.foo.github.com"，在終端里輸入"jekyll —pygments"，然后就可以用該域名訪問本地博客了，如果一切正常，再提交到github

PS:如果你之前的博客是基于wordpress/movable type/typo 4+，可以參考這篇遷移指南

綁定域名

這個就更簡單了，新建一個CNAME文本文件，在里面輸入域名，如"blog.leezhong.com"，然后在域名提供商里，指定該域名的CNAME為"foo.github.com"，搞定

添加評論功能

使用disqus ，整個注冊和使用流程還是挺清晰易懂的，這里就不多說了。

參考文章

jekyll wiki
github blog
publishing a blog with github and jekyll

后記

之前一直用的wordpress，但是太臃腫了，而且有安全隱患，還得有一個PHP空間，訪問速度也得不到保證。平時github用得比較多，正好他們提供"博客"服務(wù)，正合我意，初步使用下來，沒有什么問題，能在本地用vim寫textile語法的博客是一件多么爽的事情啊，還可以本地預(yù)覽最終效果，數(shù)據(jù)也不會輕易丟失。

最后再次感謝github提供了這么好的服務(wù)，如果對github的創(chuàng)業(yè)歷程感興趣，可以參考這篇文章

若無特別說明，本站文章均為原創(chuàng)，轉(zhuǎn)載請保留鏈接，謝謝