Mountain Lion环境安裝Octopress与Github

以前使用的wordpress blog空间被墙了，使用甚是不便，偶然发现现在很流行在github上使用Octopress搭建blog，研究了一番开干，整个过程分3大步骤，折腾了我2天的时间，才算基本搞定，现记录过程如下备忘：

Step 1 安裝Ruby 1.9.3

Mountain lion内建的ruby版本号为1.8.7，安装Octopress首先需要升级到ruby 1.9.3。 安装新版本的ruby，又必须安装以下套件。
Xcode (本机已安装Xcode 4.5)
command line utilities (已安装)
homebrew
使用brew安装libksba
rvm

安裝homebrew

基本上，安裝完rvm就可以直接升级ruby 1.9.3，但是在Mountain lion上，rvm在安装ruby 1.9.3的时候会遇到问题， 所以，必須通过brew安装libksba这个libary。 要安装homebrew，首先：

1

cd /usr/local

然后执行以下指令下载并安装homebrew：

1

mkdir homebrew && curl -L https://github.com/mxcl/homebrew/tarball/master | tar xz --strip 1 -C homebrew

安完homebrew之后，记得要设定路径，请在~/.bashrc中加入：

1

export PATH=/usr/local/homebrew/bin:$PATH

确认brew指令可以使用之后，用以下指令安装libksba：

1

brew install libksba

参考资料：
https://github.com/mxcl/homebrew/wiki/installation
http://crosstown.coolestguyplanettech.com/os-x/40-setting-up-os-x-lion-to-plug-into-homebrew-package-manager

安装rvm

安装rvm，通过rvm来更新ruby的版本，执行以下指令安装：

1

curl -L https://get.rvm.io | bash -s stable --ruby

原则上，上面这个指令，会将rvm安在~/.rvm/文件中，所以，我们必须设定rvm的路径，请在~/.bashrc中加入：

1

[[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm"

使用 rvm來安装ruby，原则上，在安装rvm的过程中，它会自动帮你安装最新版的ruby， 如果没有的话，请输入以下指令安装ruby 1.9.3：

1

rvm install 1.9.3

接着，切换ruby的版本：

1

rvm use 1.9.3

基本上，安装完ruby，可以使用以下指令查看ruby的版本

1

ruby -v

不过，rvm use 1.9.3只是暂时将ruby转成1.9.3，重新打开终端，就会变回原本的1.8.7，如果要完全切换成1.9.3， 需要将1.9.3设成default的版本：

1

rvm --default use  1.9.3

以上就是ruby 1.9.3的安装步骤。

Step 2 安装Octopress

git下载Octopress到Home目录：

1
2

cd ~/
git clone git://github.com/imathis/octopress.git octopress

如果你沒有git的話，到http://code.google.com/p/git-osx-installer/下载安装最新版本。
然后输入以下指令安装Octopress

1
2
3
4

cd ~/octopress
gem install bundler
bundle install
rake install

安装完成之后，切换到octopress的目录，使用preview预览安装是否成功：

1
2

cd ~/octopress
rake preview

输入完rake preview之后，开启safari，并输入 http://127.0.0.1:4000进行预览
通过修改_config.yml，更改Blog的一些基本的设定，如title和作者，更详细的内容参考官网。

Step 3 Deploy 到Github

Github免费平台，可以将我们的Octopress产生的html存放在github.com之下，而且还可以使用免费的Domain name。
首先到https://github.com/申请一个帐号，并且建立一个 username.github.com的仓储
github申请好之后，将本地的Octopress发布到刚申请好的github空间， 执行以下指令连接github：

1

rake setup_github_pages

接着按提示输入欲连接的仓储：
git@github.com:yourname/yourname.github.com.git
然后，使用如下命令产生页面并上传部署:

1
2

rake generate
rake deploy

如果在发布过程中可能遇到报错:Permission denied (publickey).
这是因为我们尚未在GitHub账户中正确设置公钥认证。执行以下命令生成密钥:

1

ssh-keygen -t rsa

然后根据提示在用户主目录下的.ssh目录中创建默认的公钥/私钥对文件，其中~/.ssh/id_rsa是私钥文件，~/.ssh/id_rsa.pub是公钥文件。将公钥内容复制后,拷贝至GitHub的SSH公钥设置位置。

最后，确认成功访问http://yourname.github.com，大功告成。

Comments