周末閑來無事,學習了一下怎樣利用github pages來建立自己的博客,現在比較成熟的博客系統是Octopress,關於其詳細的介紹可以參見官方文檔,本文建立的博客頁面已經綁定到了zhourunsheng.com域名,可以查看博客的效果!
1. github page 的建立
要想在github上面建立自己的博客,首先需要建立page,可以參考官方的文檔 http://help.github.com/pages/,簡單來說,比如我的github賬戶名稱是careychow,那么需要建立一個 careychow.github.com 的 repository,將博客的靜態頁面上傳到該repository的master分支中,當通過瀏覽器訪問 http://careychow.github.com的時候,github服務器就會將其中博客頁面展示出來。
2. 搭建 Octopress 本地環境
linux 環境的搭建可以參見官方文檔 http://octopress.org/docs/setup/
因為我自己通常都在win7下面辦公,所以下面介紹一下win7環境下 Octopress 的搭建和部署
a. 安裝 git,下載地址:msysgit,最新版本 Git-1.7.10-preview20120409.exe ,詳細參見 http://help.github.com/win-set-up-git/
b.安裝 ruby,下載地址: RubyInstaller,安裝版本 rubyinstaller-1.9.2-p290.exe,注意版本是1.9.2
c. 安裝gem編譯環境, 下載地址:DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe,下載完成后,將其解壓到 如 E:\DevKit,然后在win的cmd窗口中執行如下命令進行安裝:
cd E:\DevKit ruby dk.rb init ruby dk.rb instal
e. 安裝python,下載地址:activepython ,安裝2.7版,主要是博客代碼加亮模塊需要python環境的支持,安裝完以后,在win的cmd窗口中執行:
easy_install pygments
3. 更新配置
a. 中文 utf-8 編碼的支持,在win7環境變量中配置如下:
LANG=zh_CN.UTF-8 LC_ALL=zh_CN.UTF-8
b. 變更 gem 的更新源,ruby的官方更新源經常被河蟹,木有辦法,幸虧國內有淘寶做好事,提供了國內的更新源,這樣速度就快多了,變更如下:
gem sources --remove http://rubygems.org/ gem sources -a http://ruby.taobao.org/ gem sources -l 注意 :請確保只有 http://ruby.taobao.org/ 唯一一個條目
c. 安裝 rdoc 和 bundler
gem install rdoc bundler
4. 安裝 Octopress
a. 下載 Octopress 源碼
git clone git://github.com/imathis/octopress.git octopress cd octopress # If you use RVM, You'll be asked if you trust the .rvmrc file (say yes). ruby --version # Should report Ruby 1.9.2
b. 安裝依賴模塊
$ vi Gemfile 將行 : source "http://rubygems.org/" 改為 : source "http://ruby.taobao.org/" $ bundle install
c. 安裝 默認主題
rake install
如若出錯: $ rake install rake aborted! You have already activated rake 0.9.2.2, but your Gemfile requires rake 0.9.2. Using bundle exec may solve this. (See full trace by running task with --trace) 修正辦法為: $ bundle update; rake install
5. 發布博客到github pages
a. 與github建立連接
rake setup_github_pages 按照提示輸入 github page repository的url地址,例如:git@github.com:RubyLouvre/rubylouvre.github.com.git
b. 生成靜態頁面
rake generate
c. 本地預覽,訪問 http://localhost:4000 查看博客本地運行效果
rake preview
e. 發送到github 服務器,訪問 http://careychow.github.com 查看博客服務器運行效果
rake deploy
f. 保存博客源碼到github source分支
git add . git commit -m 'blog source' git push origin source
6. 配置 Octopress
a. 更新配置文件 octopress/_config.yml, ,參考http://octopress.org/docs/configuring/,示例如下,若包含中文,請將文件格式保存成utf-8的格式
url: http://zhourunsheng.com title: 潤物無聲 subtitle: 天空一朵雨做的雲 author: Carey Chow simple_search: http://google.com/search description:
b. 綁定個人域名
echo 'zhourunsheng.com' >> octopress/source/CNAME 修改域名 'zhourunsheng.com' A記錄到 207.97.227.245
c. 創建新文章和新頁面
rake new_post["article name"] rake new_page["page name"]
d. 發布到github個人空間
rake generate rake deploy
至此,一個完整的博客就搭建完畢了,具體的運行效果圖請參見我的示例空間:http://zhourunsheng.com/ http://www.cnblogs.com/gossip/archive/2012/06/30/2571316.html