Hello Bug~

[Github Pages + Octopress 搭建篇] - Geek般的写博客呦~

| Comments

一个偶然发现了Octopress，研究了一下发现真的很有意思~ 其实原理呢就是Github pages提供了存储静态页面的空间域名和Jekyll（Blog生成工具），支持Markdown格式，而Octopress呢又把Jekyll包装了一下，使用起来更方便，更可以专注在内容上啦~ 好了，开始吧~

1. 准备Github Pages

首先，得有个github账户（假设你用户名是xiaoming），在里面创建一个Repository，名字一定要是xiaoming.github.com，你才能用xiaoming.github.com的域名去访问你的blog~

然后，在你Repository的Admin里，左边选Option，右边会看到Github Pages的项，点击Automatic Page Generator按钮到下一页后，直接点击最下面的Continue to Layouts，到达选择模板页，不用选择，一会儿会被Octopress的模板替换掉，直接点击PUBLIS按钮就发布成功了，等一段时间就能生效啦~

2. 准备本地环境

官方的搭建说明文档在这里。

由于工作和游戏的种种原因，我使用的“2B青年必备”的Mac下的Win7。。。-_-

a) Git

安装Git

b) Ruby

安装RubyInstaller （>=1.9.2）

c) Gem

安装DevKit
然后在命令行执行：

1
2
3

cd path-to-devkit
ruby dk.rb init
ruby dk.rb instal

or

前三步可替换为RailsInstaller

安装RailsInstaller (包括了Ruby，Git，Gem)

d) python

安装Python，因为代码高亮系统是基于Python编写的。

3. 更改本地配置

a) 中文utf-8编码的支持

在环境变量里设置LANG=zh_CN.UTF-8，LC_ALL=zh_CN.UTF-8

b) 把gem的更新源改为taobao，因为官方的更新源总是被河蟹-_-

1
2
3

gem sources --remove http://rubygems.org/
gem sources -a http://ruby.taobao.org/
gem sources -l #这里的输出要确保只有taobao一个源

c) 安装rdoc和bundler

1

gem install rdoc bundler

4. 安装Octopress

找个合适的目录，执行下面的命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# clone octopress代码
git clone git://github.com/imathis/octopress.git octopress
cd octopress

# 修改octopress的gem源
vi Gemfile # 或notepad Gemfile
将行: source "http://rubygems.org/"
改为: source "http://ruby.taobao.org/"

# 安装octopress所需的gem组件
bundle install

# 安装默认主题
rake install

5. 关联Github Pages

a) 与Github建立连接

1
2
3

rake setup_github_pages
# 按照提示输入Github Pages Repository的url地址，如：git@github.com:xiaoming/xiaoming.github.com.git
# 这时创建了一个githug分支用来保存source文件

b) 更新blog配置文件

更新配置文件octopress/_config.yml，可参考官网说明。 这里就可以给blog起标题副标题神马的了~

c) 生成静态页面

1

rake generate

d) 本地预览

1
2

rake preview
# 可以访问http://localhost:4000查看博客本地效果

e) 发送到github上

1
2

rake deploy
# 可以访问http://xiaoming.github.com查看实际效果

f) 保存source文件到github source分支上

1
2
3
4
5

git add .
git commit -m "xiaoming blog source"
# 这里如果要pull，一定要从分支pull
# git pull origin source
git push origin source

6. 开始写博客啦。。。终于。。。

1
2
3
4

# 创建新页面
rake new_page["page name"]
# 创建新博文
rake new_post["blog title"]

官方说明在这里

然后。。。就没有然后了。。。才怪。。。改天继续总结。。。

^_^

Comments