安装

参考了很多文章基于Github Pages搭建Octopress博客,我的Octopress终于搭建成功了。网上已经很多教程,不在详述,一下罗列我参考的文章,以示感谢:

使用Octopress将博客从wordpress迁移到GitHub上

象写程序一样写博客:搭建基于github的博客

Blog = GitHub + Octopress

还有[像黑客一样写博客],可以搜索下,好多转载的,不给出具体地址了。

基本上参考文章大同小异,当然有些会很详细,有些是概述。

注意事项

安装过程虽然好多文章都写的很简单顺利。但是实际环境不同,会遇到很多不同的问题,以下记载我安装以及使用中遇到的问题。

1.Ruby版本问题

Ruby一定要是至少9.2版本的。ubuntu系统不要使用系统默认可安装的,是8.x版本的。我最后使用rvm安装的。由于不懂Ruby,不谈论安装细节啦。

2.git配置问题

发布文章时,使用的是全局的git配置,不能使用在octopress项目下配置的git用户名和邮箱。

解决:明明配置了.git/config文件,为什么发布文章使用的还是全局的git用户名和邮箱?虽然不懂Ruby,但是看打印出的信息,_deploy文件夹都是删除重新生成,也就说说文件夹的git信息都是重新初始发的!然后大概了解了下,Ruby使用Rakefile文件,硬着头皮打开看看吧。果然看到deploy_dir的git信息都是重新初始化的!这下好办了,在每个git init后面加入:

git config user.name  yourname
git config user.email youremail

2个地方都加上了,再次发布文章,已经显示你填写的用户名和邮箱啦。

3.源码备份问题

博客程序发布会占用github的master分支。想备份整个程序源码的话,其实也很简单。因为发布过博客以后,本地分支名字已经变成source。只需要简单的push到github上就行了。这样:master分支是博客内容,source分支,是用来发布的程序,包括博客文章的备份。

4.命令不熟悉

以下列举安装成功以后,发布文章要用到的命令:

  1. 本地预览:rake preview 地址:http://localhost:4000
  2. 创建文章:rake new_post[‘Hello World’]
  3. 生成静态文件:rake generate
  4. 发布文章:rake deploy

我的第一篇Markdown博客

用到了标题,链接(参考式),有序列表以及代码区块。