安装
参考了很多文章基于Github Pages搭建Octopress博客,我的Octopress终于搭建成功了。网上已经很多教程,不在详述,一下罗列我参考的文章,以示感谢:
使用Octopress将博客从wordpress迁移到GitHub上
还有[像黑客一样写博客],可以搜索下,好多转载的,不给出具体地址了。
基本上参考文章大同小异,当然有些会很详细,有些是概述。
注意事项
安装过程虽然好多文章都写的很简单顺利。但是实际环境不同,会遇到很多不同的问题,以下记载我安装以及使用中遇到的问题。
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.命令不熟悉
以下列举安装成功以后,发布文章要用到的命令:
- 本地预览:rake preview 地址:http://localhost:4000
- 创建文章:rake new_post[‘Hello World’]
- 生成静态文件:rake generate
- 发布文章:rake deploy
我的第一篇Markdown博客
用到了标题,链接(参考式),有序列表以及代码区块。