您的位置: 首页  >  IT文章  >  在github Pages上调度octopress搭建个人博客系统

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

分类: IT文章 • 2022-05-13 00:31:10
在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后，在命令行输入以下命令来进行安装：

1
2
3

cd /d D:\DevKit
ruby dk.rb init
ruby dk.rb install

用Git下载octopress源代码到本地

1
2

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

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

安装Octopress依赖项

1
2
3

cd octopress
gem install bundler
bundle install

安装octopress默认主题

1
2

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路径到本地

1
2
3
4

$ rake setup_github_pages
Enter 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解决

部署你的博客

1
2

rake generate
rake deploy

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

提交的source目录

1
2
3
4

cd /d D:\ruby\octopress
git 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 错误

1
2
3
4

d:\ruby\octopress>rake install
rake 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’ 不是内部或外部命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

d:\ruby\octopress>rake setup_github_pages
Enter 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.io
Added remote git@github.com:caiqinghua/caiqinghua.github.io as origin
Set origin as default remote
Master branch renamed to 'source' for committing your blog source files
rm -rf _deploy
mkdir _deploy
cd _deploy
Initialized empty Git repository in d:/ruby/octopress/_deploy/.git/
'My Octopress Page is coming soon
'hellip' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
[master (root-commit) 7e72dcf] Octopress init
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 index.html
cd -
---
## Now you can deploy to git@github.com:caiqinghua/caiqinghua.github.io with `ra
ke deploy` ##

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

　4. rake deploy

1
2
3
4
5
6

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

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

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

1
2
3
4

## Pushing generated _deploy website
Enter 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错误，修改后，重试，部署完成

1
2

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

修改为

1
2

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

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

1
2

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


应该修改为

1
2
3

[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

相关推荐