Win7下搭建基于Github Pages的Octopress博客

能找到这里的大概也都清楚octopress是什么了,这里不做多说
什么是octopress请看官网http://octopress.org/
什么是jekyll也请看官网http://jekyllrb.com/
花了两天时间终于成功搭好了,这里说下流程和遇到的一些坑,主要是自己对git命令不熟,又是第一次接触ruby,再加上坑爹的网络,哎,说多了都是泪,浪费了很多时间。

Octopress 在 git 中维护,需要安装 git
msysgit 查找下载最新版本

Octopress/Jekyll 是 ruby 应用程序,需要安装 ruby
ruby提供windows的一键安装包,地址http://rubyinstaller.org/downloads/
Octopress现在是需要Ruby 1.9.3-p545的版本
另外windows还需要下载DEVELOPMENT KIT,下载支持ruby1.9.3版本的DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe
将 DevKit 自解压包释放到 C:\DevKit

安装后,确保 C:\Ruby192\bin 在 Windows 当前用户的 PATH 环境变量中切记加环境变量

安装后需执行如下步骤
cd到C:\DevKit目录
在 Windows CMD 窗口中执行 ruby dk.rb init
在 Windows CMD 窗口中执行 ruby dk.rb install

设置 gem 的更新源
gem sources –remove http://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l # 请确保只有 https://ruby.taobao.org 一行输出
安装 bundler

gem install bundler

这里要说下更新源的问题,淘宝的也不一定就可以用,要看自己的网络,你可以先把自己的网络DNS改成8.8.8.8,然后直接安装bundler,如果成功了就不要改了,如果不成功就改淘宝的吧,这里是要看网络情况的,失败了就一直试到成功为止。

到这里环境基本上就配好了,下面是安装octopress

cd 到你想要保存octopress的目录下,然后在终端输入:

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

下一步是安装相关的依赖,cd进octopress目录,执行:

bundle install

这里也是需要网络,如果上面你设了8.8.8.8成功了的话就直接执行,如果用了淘宝的成功了,那这里改下Gemfile文件的第一行的网址,把‘http://rubygems.org/’改成‘http://ruby.taobao.org/’,这样它连的就是淘宝的了。

最后安装默认主题:

rake install

这样子octopress就算基本搭建好了,下面的步骤就是怎么上传到github上了。

首先在 Github 上创建一个由你自己的用户名组成的repository,如yourusername.github.com,注意这里必须是由你自己的username 组成。(注意这里一定要是.com结尾的,尼玛官网说可以用.io结尾,根本不行,被坑惨了)

创建好了repository之后就可以自动生成github的页面,输入:

_rake setup_github_pages_

然后终端会让你输入你Github上的repository地址,这里注意不要根据它给的样式输入,找到自己的仓库地址,格式是:git@github.com:yourusername/yourusername.github.com.git,这里如果输入错误,之后就提交不到仓库了。

然后输入

rake generate
rake deploy

最后把代码提交到仓库了

git add .
git commit -m ‘Initial octopress’
git push origin source

这里需要会点git,我被坑了好久。第一次提交会有两个分支,一个是source分支,一个是master分支。source管理博客的源码,master分支用于管理生成的内容。(如果不是,说明你提交错了。。。)
Octopress的做法似乎是把master分支对source下的source文件夹做了映射,然后每次都会deploy的时候都会把这个文件夹提交到master。

到了这一步,就可以在浏览器输入yourusername.github.com访问你的Github Pages了。

参考文章:
http://sinosmond.github.io/blog/2012/03/12/install-and-deploy-octopress-to-github-on-windows7-from-scratch/
http://www.nsguy.com/blog/2013/12/07/%E5%8A%9B%E9%87%8F%E7%9A%84%E8%B5%B7%E6%BA%90/