用Octopress在github上搭建博客

###1. 新建username.github.io代码仓库

在github上搭建博客,第一步一定是在自己的账号下建立一个名为 username.github.io的代码仓库,github会自动识别该仓库,并将它发布到 username.github.io这个子域名上,详情见 pages.github.com

###2. 下载并安装Octopress

从github上下载代码库需要先安装git,关于git的使用,可以参考 Pro Git

$ git clone git://github.com/imathis/octopress.git octopress 
$ cd octopress

安装之前需要配置好ruby环境,具体步骤可以在ruby-china的wiki上找到如何快速正确的安装Ruby,Rails运行环境 Octopress需要Ruby1.9.3及以上版本,并且使用rbenv或RVM

$ gem install bundler rbenv rehash #如果你使用rbenv bundle install

至此,就完成了在本地的Octopress安装。

###3. 修改配置文件,部署到github

在终端输入

$ rake setup_github_pages

根据提示输入你的github仓库地址,如git@github.com:username/username.github.io.git 接着

$ rake generate 
$ rake deploy

至此,Octopress的部署就完成了,你可以访问 username.github.io 查看部署的结果。 另外别忘了把你的源码提交到github

$ git add .
$ git commit -m ‘your message’ 
$ git push origin source

Octopress的配置文件在_config.yml中,可以直接编辑进行修改,可以设置标题,作者等。修改完成后通过

$ rake generate 
$ rake deploy

使修改在github上生效。

###4. 发布新博文

$ rake new_post[“title”]

标题会体现在博文的网址中,网址的结构可以在config.yml中设置。生成的空博文在source/ posts/ 中,格式为 时间加标题,后缀为markdown。生成后通过修改此文件,来写博文。markdown相关语法 博文修改完成后,依然使用

$ rake generate
$ rake deploy

正式发布到您的博客中。

更多操作技巧和功能应用见 Octopress 。