在github Pages上调度octopress搭建个人博客系统

在github Pages上部署octopress搭建个人博客系统

原文链接：http://caiqinghua.github.io/blog/2013/08/26/deploy-octopress-to-github-pages/

引子

上一篇博客已经说了为什么要搭建这个博客系统，本文不再啰嗦，单刀直入，说以下主题。 1. Octopress是什么 2. Github Page是什么 3. 部署Octopress到Github Pages的过程 4. 部署中遇到的问题

理解本文的基本知识

1. windows命令行基本使用方法（运行中输入cmd，输入enter)
2. git(学习资料: Pro Git 简体中文版，请自行google下载)
3. github(github.com)
4. ruby(本文只要会安装，会用几条命令即可)

什么是octopress?

自动化创建静态博客工具，包括一些模板和一些批处理工具。 用ruby和sass实现的，作者imathis也是compass的作者，compass是什么不是本文的关注点，请读者自行google了解。

什么是github pages?

github静态页面，为项目做宣传主页之类的用处。

为什么部署到github pages?

github pages免费空间，免费流量，每次的博客改动和博客模板的改动都由git跟踪。没有理由不选择。

step by step 部署Octopress到Github Pages

准备

系统：Windows 7

Git：下载地址

Ruby：下载地址 注意: 部署octopress到github之前我已经安装过ruby on rails，所以我没有安装上面的ruby 1.9.3。 我安装是railsinstaller-2.2.1，详情请查看：http://railsinstaller.org/en 所以下面的安装过程出很多问题也许和此有关，所以还是建议直接安装ruby 1.9.3，不要安装railsinstaller。

DevKit：下载地址

Octopress：git://github.com/imathis/octopress.git

安装软件

安装Git Windows下安装Git很简单，一路next就可以了。

安装Ruby Ruby的安装也是一路next就可以，不过记得勾选“Add Ruby executables to your PATH”，将Ruby的执行路径加入到环境变量中，如果忘记勾选，也可以手动设置。安装完后可以在命令提示符中输入ruby –version 来确认是否安装成功。

安装DevKit DevKit下载下来的是一个自压缩文件，我们将其解压到D:/DevKit，有两点需要注意：

1. 解压目录中没有有中文和空格；
2. 必须先安装Ruby，而且Ruby需要是RubyInstallser安装。

解压DevKit后，在命令行输入以下命令来进行安装：

123

cd /d D:\DevKitruby dk.rb initruby dk.rb install

用Git下载octopress源代码到本地

12

cd /d D:\rubygit clone git://github.com/imathis/octopress.git octopress

下载完成后会在D:\ruby文件中生成octopress文件夹，下面的操作都是基于这个文件夹。

安装Octopress依赖项

123

cd octopressgem install bundlerbundle install

安装octopress默认主题

12

cd octopress$ rake install

创建第一篇博客

1

$ rake new_post["My first octopress blog"]

本地预览生成的博客系统和博客

1

$ rake preview

打开浏览器访问 http://localhost:4000/%EF%BC%8C%E4%BD%A0%E7%9A%84%E7%AC%AC%E4%B8%80%E7%AF%87%E5%8D%9A%E5%AE%A2%E5%B0%86%E5%91%88%E7%8E%B0%E5%9C%A8%E7%9C%BC%E5%89%8D%E3%80%82

以上已经把octopress博客系统和第一篇博客生成了，接下来要把生成的博客系统和博客部署到github pages。

创建git repository

https://github.com/ Create a new repo 输入名称 username.github.com，注意username改为你的username，不能省略后面的github.com。 eg. caiqinghua.github.com

设置刚刚创建的repository路径到本地

1234

$ rake setup_github_pagesEnter the read/write url for your repository(For example, 'git@github.com:your_username/your_username.github.com)Repository url: 

请输入：git@github.com:yourname/yourname.github.com.git (将yourname替换成你的github登录名)

注意:这一步不要输入提示中提示的以io结束的地址。

设置SSH

设置步骤自行google解决 也可以不设置SSH,每次输入githib密码上传，请自行google解决

部署你的博客

12

rake generaterake deploy

一面的deploy只是把_deploy目录上传到你的repo的master分支，即只是把生成的静态博客站点上传到github pages了。下面还需要把生成这个静态站点工具上传到repo的source分支

提交的source目录

1234

cd /d D:\ruby\octopressgit add .git commit -m "My octopress blog source code"git push origin source

到github.com查看你上面新建的repository，会多一个source分支，记载所有的源文件。

安装过程中遇到的问题

1. bundle install 过程中Installing rdiscount (2.0.7.3) 安装失败

猜测原因：DevKit问题 把Ruby200中的DevKit删除，把path中c:\Ruby200\devkit 删除 重新执行bundle install 成功了

2. rake install 错误

1234

d:\ruby\octopress>rake installrake aborted!You have already activated rake 10.1.0, but your Gemfile requires rake 0.9.2.2.Using bundle exec may solve this.

解决办法： 修改octopress/Gemfiles gem ‘rake’, ‘~> 0.9’ 改为 gem ‘rake’ 再次rake install成功了

　3. rake setup_github_pages ‘hellip’ 不是内部或外部命令

1234567891011121314151617181920212223

d:\ruby\octopress>rake setup_github_pagesEnter the read/write url for your repository(For example, 'git@github.com:your_username/your_username.github.io)           or 'https://github.com/your_username/your_username.github.io')Repository url: git@github.com:caiqinghua/caiqinghua.github.ioAdded remote git@github.com:caiqinghua/caiqinghua.github.io as originSet origin as default remoteMaster branch renamed to 'source' for committing your blog source filesrm -rf _deploymkdir _deploycd _deployInitialized empty Git repository in d:/ruby/octopress/_deploy/.git/'My Octopress Page is coming soon'hellip' 不是内部或外部命令，也不是可运行的程序或批处理文件。[master (root-commit) 7e72dcf] Octopress init1 file changed, 0 insertions(+), 0 deletions(-)create mode 100644 index.htmlcd ----## Now you can deploy to git@github.com:caiqinghua/caiqinghua.github.io with `rake deploy` ##

google: ‘hellip’ 不是内部或外部命令，也不是可运行的程序 http://pythonee.github.io/blog/2012/08/10/how-to-octpress/ 这个错误无关痛痒，无需解决。

　4. rake deploy

123456

## Pushing generated _deploy websitePermission denied (publickey).fatal: Could not read from remote repository.Please make sure you have the correct access rightsand the repository exists.

解决办法：设置ssh，前面已经提及

　5. 再次rake deploy，发生以下错误

1234

## Pushing generated _deploy websiteEnter passphrase for key '/c/Users/Lin/.ssh/id_rsa':ERROR: Repository not found.fatal: Could not read from remote repository.

问题原因：rake setup_github_pages 中 git@github.com:caiqinghua/caiqinghua.github.io设置错误，应该设置为 git@github.com:caiqinghua/caiqinghua.github.com.git 解决办法： 查看octopress_deploy.git\config

发现url错误，修改后，重试，部署完成

12

[remote "origin"]     url = git@github.com:caiqinghua/caiqinghua.github.io

修改为

12

[remote "origin"]     url = git@github.com:caiqinghua/caiqinghua.github.com.git

注意: octopress.git\config 中的url也生成错了。

12

[remote "origin"]     url = git@github.com:caiqinghua/caiqinghua.github.io

应该修改为

123

[remote "origin"]     url = git@github.com:caiqinghua/caiqinghua.github.com.git     fetch = +refs/heads/*:refs/remotes/origin/*

重新执行rake gen_deploy执行成功了

立即访问 caiqinghua.github.com，提示404 页面未找到错误 10分钟后访问，可以看到本地预览的博客了。 到此部署octopress到github pages总算完成了。

后记

octopress中用markdown格式撰写博文，关于markdown语法，如何撰写博客，如何个性化设置博客，且听下文分解。

Posted by 蔡清华 caiqinghua@126.com Aug 26th, 2013  opensource, tools