使用github作爲博客引擎

書名:版本控制之道
豆瓣評分:7.7分(203人評價)
博主評價:
未評價很差較差還行推薦力薦
來自豆瓣讀書資源

文章出處:無網不剩

在介紹之前,先普及一下基礎知識,大鳥們直接跳過。

什麼是git

git是一個分佈式版本控制工具(DVCS),不需要服務端軟件支持(即使在地鐵裏也可以正常commit),Linux內核開發用的版本控制工具就是它。

常用的SVN屬於集中式版本控制工具(CVCS),需要在服務端開啓SVN服務,然後客戶端checkout,commit,update。

更詳細的介紹請參考維基百科

什麼是github

github 的標語是:"secure source code hosting and collaborative development"。一個基於git的類似google code的代碼倉庫,付費版的用戶可以創建私有倉庫,支持多人開發。很多項目都選擇了github來保存代碼,如"jQuery/reddit/RoR /CakePHP/Redis"等等。

github pages

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

創建一個用戶的頁面很簡單,假設你的用戶名爲foo

1. 新建一個倉庫(repository),名稱填"foo.github.com",創建
2. 在本地新建一個文件夾,假如爲foo,在foo裏面新建一個index.html頁面,隨便輸入點內容
3. `git init` 初始化,`git add .` 把index.html加入到倉庫中,`git commit` 提交修改
4. 添加github的分支 `git remote add origin [email protected]:foo/foo.github.com.git`
5. 提交到github分支 `git push origin master`

過1分鐘左右,瀏覽foo.github.com,就可以看到剛剛創建的index.html文件了。

除了創建用戶頁面,還可以針對每個項目單獨創建項目的主頁,這不是本文的重點,有興趣的可以瀏覽此頁

創建blog

終於扯到正題上了(-,-),前面已經說過如何創建html頁面,其實已經可以寫博客了,創建一個index.html頁面,在裏面列出寫過的文章,點擊標題進去後又是一個手動創建的html頁。就是太麻煩了,一點都不酷,說不定還會被MM鄙視。

github當然知道這個問題,所以他們創建了jekyll模板引擎 。簡單來說,就是你可以用textile 或者markdown語法來寫博客,提交到github後,會自動轉換成html。

這裏有很多網站/博客,都是基於github的jekyll模板開發的,如果覺得哪個不錯,可以查看source。

先來看看這個倉庫,裏面有一些特殊的文件/文件夾:

_config.yml

存儲了一些設置,大部分的設置都可以通過命令行指定,但放到配置文件裏更方便些

_layouts

_layouts文件夾存放的是模板文件,文章會被渲染到這些模板裏,變量指代的是文章內容

_posts

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

_site

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

index.html

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

other files/folders

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

jekyll的安裝

參考安裝頁 ,如果使用時提示"liquid requires RubyGems version >= 1.3.7",可以在這裏 下載對應的文件,安裝即可。

安裝完之後,爲了避免路徑調用問題,可以在apache/nginx裏給對應的文件夾(/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用得比較多,正好他們提供"博客"服務,正合我意,初步使用下來,沒有什麼問題,能在本地用vim寫textile語法的博客是一件多麼爽的事情啊,還可以本地預覽最終效果,數據也不會輕易丟失。

最後再次感謝github提供了這麼好的服務,如果對github的創業歷程感興趣,可以參考這篇文章


--EOF--

若無特別說明,本站文章均爲原創,轉載請保留鏈接,謝謝

發佈了302 篇原創文章 · 獲贊 11 · 訪問量 16萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章