现在的位置: 首页 > Web设计> 正文
利用GitHub Pages安装部署Octopress博客
2012年04月15日 Web设计 评论数 2 ⁄ 被围观 3,912+

周末闲来无事,学习了一下怎样利用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:careychow/careychow.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/

目前有 2 条留言 其中:访客:1 条, 博主:1 条

  1. Christopher Meng : 2012年04月21日00:40:29  -49楼 @回复 回复

    一直考虑要不要废了Wordpress

    • 润物无声 : 2012年04月22日22:27:51 @回复 回复

      这倒木有那个必要,wordpress作为个人博客系统还是非常优秀滴!

给我留言

留言无头像?


×
腾讯微博