文章出處:無網不剩
在介紹之前,先普及一下基礎知識,大鳥們直接跳過。
什麼是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--
若無特別說明,本站文章均爲原創,轉載請保留鏈接,謝謝