文章目录
  1. 1. 搭建环境
  2. 2. 首次搭建
    1. 2.1. 准备工作
    2. 2.2. 安装OctoPress
    3. 2.3. 配置
    4. 2.4. Github page托管服务
    5. 2.5. 创建第一篇博客试试
    6. 2.6. 第一次部署
    7. 2.7. 打完收工
    8. 2.8. Clone 已存在的博客Repository(第二次部署)
    9. 2.9. 其他的后话

经过一番折腾,终于把OctoPress成功部署在github上了。
下面就把搭建过程集结成册,记录下来,方便日后使用。
PS: 搭建的过程中参考了唐巧的这篇博客象写程序一样写博客:搭建基于github的博客


搭建环境

Mac : OSX Mavericks 10.9.1  
Ruby : ruby 2.0.0p247 (2013-06-27 revision 41674) [universal.x86_64-darwin13]
Git : git version 1.8.3.4 (Apple Git-47) 

首次搭建

准备工作

首先需要安装一些必要的工具。这些内容在OctoPress官网 上有详尽的说明。我只是把 OS Mavericks 10.9 下需要做的事情罗列一下。
首先安装rvm
安装:

1
sh -s stable < <(curl -s https://raw.github.com/wayneeseguin/rvm/master/binscripts/rvm-installer)

设置classpath:
shell为系统默认的情况(大多数)

1
2
echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm" # Load RVM function' >> ~/.bash_profile
source ~/.bash_profile

shell 为zsh

1
2
echo '[[ -s $HOME/.rvm/scripts/rvm ]] && source $HOME/.rvm/scripts/rvm' >> ~/.zshrc
source ~/.zshrc

安装OctoPress

先找一个你熟悉的文件路径,然后从github上将源码Clone下来:

1
git clone git://github.com/imathis/octopress.git octopress

进去看看

1
cd octopress

然后安装依赖:

1
2
sudo gem install bundler
bundle install

最后安装OctoPress

1
rake install

配置

主要是修改配置文件: __config.yml
详细的配置项就不解释了,注释里写的很详细。
需要注意的是:
要把配置文件中的关于twitter信息删除,原因是GFW。
定制文件/source/_includes/custom/head.html 把google的自定义字体去掉,原因同上

Github page托管服务

怎么做?不详细说了,参见官网Github pages

创建第一篇博客试试

1
2
3
rake new_post['My first blog']
rake generate
rake preview

然后在浏览器地址栏里输入
http://localhost:4000/
看到效果了么?Ok,试试下一步“部署”吧。

第一次部署

简单,看看官网的说明就好了官网链接

打完收工

提交成功后,再试试你的github page能不能如期显示。
浏览器地址栏里输入:

1
githubUserName.github.io

本来文章写到这里就应该完成了,可是还是碰见问题了。

Clone 已存在的博客Repository(第二次部署)

因为我常常是在公司和家里写博客,所以需要两套写博客的环境,因此需要在其他环境下Clone 这个托管在github上的博客Repository。怎么做呢?
参见这篇博客:
Setup an Existing Octopress Repository After Git Clone
和这一篇Writing Octopress Blog on a Second Machine


其他的后话

搭建好了环境只是万里长征的第一步,博客是用Markdown写的,所以要想写博客还是先学学Markdown的语法吧。
先来个极其性感的简明教程: Markdown简明教程
再来个完整版的: Markdown 语法教程

文章目录
  1. 1. 搭建环境
  2. 2. 首次搭建
    1. 2.1. 准备工作
    2. 2.2. 安装OctoPress
    3. 2.3. 配置
    4. 2.4. Github page托管服务
    5. 2.5. 创建第一篇博客试试
    6. 2.6. 第一次部署
    7. 2.7. 打完收工
    8. 2.8. Clone 已存在的博客Repository(第二次部署)
    9. 2.9. 其他的后话