在github上用octopress搭建博客过程纪要

几个小时之前刚在github pages上使用octopress搭建了一个博客副本。本来基于本人一贯拖延的作风,是想过几天再记录整个过程的,但是正好在通宵工作但又暂时无事可干中,所以还是趁记忆还比较清晰的时候来搞定它。

在开始写过程之前先要交待一下我为什么要去做这件事,又或者说是这么做有什么好处:

  • 首先这么做需要那么一点点伪技术,所以看上去就会比较geek一点。
  • 其次这整个服务的搭建是完全免费的,可能对于比较穷困的专业挨踢的我来说会是一个开源节流的渠道。
  • 然后用octopress来写博客,最后发布的动作很cool。
个人感觉很帅气
1
2
3
rake generate
rake preview
rake deploy
  • 最后则是离线写博客很舒服,拥有纯文本markdown,良好的html支持,不使用数据库,完美的版本控制,静态页面生成等诸多优点。

好了,现在开始整个服务搭建过程记录,可能比较长:

安装Git并进行配置

  • 先注册一个github账号。
  • 下载并安装Git。
  • 到Git的安装目录找到Git Bash.lnk并打开。
  • 执行ssh-keygen -t rsa -C "your_email@youremail.com",回车。
  • 然后输入两遍密码。
  • 到c:\Users\用户名.ssh\目录找到id_rsa.pub,并用文本软件打开复制全部。
  • 到github网站选择“Account Settings”>>“SSH Public Keys”>>“Add another public key”,将刚才复制的内容粘贴到key文本框内。

建立github pages

  • 创建一个新的Repository。这里需要注意的是,如果想要博客的首页是http://yourname.github.com,则Repository的project name就必须是yourname.github.com。
  • 根据github给出的指导进行一些命令的键入,即可完成pages的建立。

安装Ruby

  • 这里要指出一点的是,因为我是在windows里安装,所以采用了RubyInstaller的方式,下载这个软件需要翻墙。
  • 另外别忘记在同一个网站上下载DevKit,必须安装。

安装octopress

  • 获取octopress,执行git clone git://github.com/imathis/octopress.git myblog
  • gem install bundler(记得翻墙)
  • bundle install(还是要翻墙)
  • rake install

到了这一步基本上可以开始写日志了,不过这里要给出两个小的tips。

修改配置

  • 将octopress的目录内的_config.yml的编码改成UTF-8。
  • 到Ruby的安装目录\lib\ruby\gems\1.9.1\gems\jekyll-0.11.0\lib\jekyll\找到convertible.rb这个文件,修改self.content = File.read(File.join(base, name))self.content = File.read(File.join(base, name), :encoding => "utf-8")
  • 修改配置文件_config.yml,修改url、title、subtitle、author等等。

总算到了激动人心的一步了,开始写日志

  • 执行rake new_post["my first blog"],这样会在octopress的/source/_post下生成一个markdown文件,可以用文本软件进行编辑
  • 完成编辑后执行rake generate,生成。
  • 执行rake preview地,可以在浏览器内以这个地址进行预览。
  • 最后执行rake deploy,将日志提交到github上,完美收工!

补充一点

最后的但并不最不重要的,我们需要将修改的日志同步到github上,因此下面的3个命令也是必须的。

1
2
3
git add .
git commit -m 'your message'
git push origin source

Comments