利用GitHub Pages安裝部署Octopress博客


周末閑來無事,學習了一下怎樣利用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


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM