Create Blog Use Octopress and GitHub
注：本博文来作者的其他博客GeekerProbe，但是均为原创，要获得最佳阅读效果请移步至GeekerProbe。
介绍
现下大概每一个搞技术的人都会有一个技术博客，而GitHub又是广大搞程序的人都知道的一个著名代码托管网站，它的优点众多，其中之一就是GitHub Pages，他是用来给当前的project作介绍说明之用的，鉴于此我们可以将自己blog放置上去，代码交由GitHub托管，每次我们只需要发博文上去就好，对我们来说这是一件多么爽快人心的事啊。Octopress就是这样一款framework，它能部署在Github上，而且很方便使用，当把它配置好之后，几条命令就可以将博文发布上去，正如官网介绍的一样A blogging framework for hackers.，像骇客一样的写博客，这很不错我很喜欢，具体的介绍可以去官网看。
这两者一结合就有了我现在的这个blog了，用它来记录和分享我的学习之路上点点滴滴。网络上有很多介绍安装与配置方法的文章，官网的Documentation写的也很好，推荐E文好的直接去官网。我在安装与配置中也遇到了各种问题，不过在Google的帮助下都一一解决了，你需要懂一些ruby(jekyll)，并且会使用git命令，还要使用markdown来书写博文，这会让你觉得是在写代码而不是在写博文。不多说了现在记录下我自己安装与配置过程，供新手与日后自己需要时参考。
我主要参考的文章：
Octopress Documentation
http://ishalou.com/blog/2012/10/15/how-to-use-octopress/
http://mrzhang.me/blog/blog-equals-github-plus-octopress.html
git 简易指南
安装前准备工作
你需要一个GitHub的账号，注册不说了，已有的跳过。
你需要在你的机器上安装并配置
git，官方文档说的很清楚，这要用到terminal，也就是命令行，懒的人可以安装可视化工具GitHub，我建议还是使用命令行，以为之后众多操作都是必须使用命令行来完成的，而且这对于hacker们来说也不是什么难事。为GitHub创建
SSHKeys，官方文档，这一步很重要，不然之后使用rake deploy命令时会出现如下错误：
## Pushing generated _deploy website Permission denied (publickey).
由于我使用GitHub比较早，这个SSH Key早就生成添加到了GitHub上，但是没有使用默认的名字，始终都是Permission denied。直到在GitHub上的文档中爬了很久才找到解决办法，o(�s□�t)o原来是生成的publickey没有添加到SSH中。4. 你的机器要有ruby环境，Octopress要求的是ruby-1.9.2，现在ruby最新的版本是ruby-1.9.3。可以使用ruby --version命令来查看。如果没有该命令或者是版本低于1.9.2的话，那么就需要安装与升级ruby。可以使用两种方法rbenv和RVM。具体使用方法请自行查看之，我是用的RVM，在安装中遇到的问题就是我是用的是MAC OX MountainLion（10.8.2）系统，xcode的版本是4.6，没有gcc编译器，用得是LLVM，而ruby-1.9.3-p385在LLVM下编译不通过。最终在Google和stackoverflow帮助下解决之。
安装Octopress
在terminal下进入Octopress所要安装目录的上一级目录，敲入以下命令
git clone git://github.com/imathis/octopress.git geekerprobe # 从GitHub上clone Octopress到本地 geekerprobe可以随便填， #Octopress会被clone到当前目录的geekerprobe目录下 cd geekerprobe # 进入该目录，如果你是用的是RVM的话，会寻问你是否信任.rvmrc文件 当然是yes gem install bundler # 下载bundler，有可能提示gem命令未找到，请自行google解决方法 bundle install #安装bundle rake install #安装Octopress默认主题
到此Octopress在本地已经安装完毕，但是还都是默认配置，而且没有发表博文。但是你可以通过一下命令来生成并预览一下原始的界面：
rake generate #生成blog，就是根据配置文件，将主题、模板、发表的markdown # 格式的博文等众多文件生成静态的html文件存放在geekerprobe/public文件夹下 rake preview #预览生成的blog，此时ruby会启动一个小型的server
接下来打开浏览器访问http://127.0.0.1:4000就可以看到页面啦！退出预览当然是Ctrl+C了。
Octopress简单配置
此时在terminal下使用‘ls’命令查看目录结构为：
CHANGELOG.markdown Rakefile plugins Gemfile _config.yml public Gemfile.lock config.rb sass README.markdown config.ru source
\_config.yml、Rakefile、config.ru和config.rb就是四个配置文件了，我们修改配置主要是在\_config.yml上进行的，其他的三个一般不需要我们去直接管理。\_config.yml的配置分为三个部分：
Main Configs，配置一些博客的基本信息，标题URL什么的；
Jekyll & Plugins，这里是jekyll和一些官方插件的配置；
3rd Party Settings，这里是第三方插件配置，我们之后自己添加的插件配置信息建议都放在这个部分中。具体说明请看官方Document。注意：每次做完配置文件的修改之后都要使用
rake generate来重新生成html来使配置生效，而简单修改页面html则不需要重新生成，在预览状态下直接刷新页面就可以了。
发布博文
博文有两种一种是post一种是page，具体有什么区别请google之。发送博文只需要在当前目录下：
rake new_post["My First Blog"] #发送名为My First Blog的post， # 会在source/_post目录下按照配置文件生成markdown文件 rake new_page["title"] #发送page，会生成在source/下，我还没有使用过具体请看官方文档
使用喜欢的编辑器打开source/_post/yyyy-mm-dd-my-first-blog.markdown进行编辑，书写博文。
--- layout: post title: "My First Blog" date: 2013-02-23 09:01 comments: true categories: --- ## Hello octopress! ##
开头两个下划线之间的部分是yaml头，用来告诉Jekyll怎么处理你的posts或者是pages，在这里你可以对你的post或者page做一些设置，比如添加作者，category，是否允许评论等。在后面就是你自己要写的东西啦，当然是使用markdown来写了，当然它也支持HTML。markdown很简单，还不会的看这里,语法说明。写完保存generate preview就可以了。
部署到GitHub
现在到了最关键的时候了，就是将Octopress部署到GitHub上去。从官方文档了解到，部署到GitHub上有两种一种是使用GitHub Pages，这种在访问时使用的url为http://username.github.com，username为注册的GitHub用户名，你需要在GitHub上建立名字为username.github.com的repository。第二种是使用GitHub Project pages (gh-pages)，这种在访问时使用的url为http://username.github.com/reponame,reponame为你在GitHub上建立的repository的名字，这个名字可以随便写，将来生成的静态html会被push到该repo下的gh-pages分支中。我个人的理解是GitHub建立了这两种方式，第一种是用来介绍你这个GitHub的，所以每个账号只能有一个，而第二个是用来介绍你的project的，而你可以建立多个repo，所以也就可以有多个blog了，虽然url有点复杂，不过Octopress也提供了绑定自己域名的方法，自己目前还没有域名所以使用的是默认的，这一部分自己没有试验过所以就不贴上来了，具体的查看官方文档。鉴于此我使用了第二种方式来将blog部署到GitHub上。步骤：
先到GitHub上创建名为
geekerprobe的repo。因为使用第二种方法我们要将blog放在
username.github.com的子集目录所以我们要在本地将目录也设置为子集目录，不然会出现“Sorry！I can not find /”的错误，如果使用第一种方法则跳过此步骤，因为默认就是没有子集目录的。
rake set_root_dir[/geekerprobe] #将路径设置为/geekerprobe rake set_root_dir[/] #如果你想恢复到初始目录，则键入此命令
这条命令会修改\_config.yml、Rakefile和config.rb中的有关路径部分的设置，并将实际文件进行剪切移动操作，以适应路径的改变。而且在本地预览时也要使用子集目录来访问预览http://127.0.0.1:4000/geekerprobe。
接下来就是将blog部署上去了
rake setup_github_pages #将Octopress部署到GitHub上
会提示你输入一个形如[email protected]:username/geekerprobe.git的地址，那么就按照这种形式输入你自己的repo的地址，这个地址可以在GitHub上你的repo的SSH文本框中得到，粘贴过来就好。
回车确定，等待片刻提示成功就可以了。这时查看目录会发现多了一个_deploy的文件夹，这个文件夹是一个git库，指向了GitHub上你的repo的gh-pages分支。同时你的repo的gh-pages分支在GitHub上也已被创建了。
接下来生成并push博文到GitHub上
rake generate #生成 rake deploy #push到GitHub上，此时会将/public目录下的文件完全拷贝， # 粘贴到/_deploy目录下，然后在push
如果你的GitHub的SSH Key没有设置或者设置错误的话，此时会出现权限不允许的错误。看到成功时就说名部署工作已经完成了，恭喜你赶紧到浏览器访问一下你的url试试看吧。
到此基本的工作已经做完了，你的blog已经成功部署到GitHub上了并且可以正常使用了。
使用 发布博文
rake new_post[] #创建post，在editer中编辑post rake generate #生成静态html rake preview #本地预览，修改错误，查看效果 rake deploy #无误后，push到GitHub上
到此，你可以离开此页了，如果还要看其他设置的话，请看下去，我觉得这还是挺有用的，他将你的posts也同样备份到GitHub上，下次在你换了一个环境或者电脑后，就可以直接clone下来或者pull合并，免去博文与各种配置丢失。
备份Octopress到GitHub
此处使用的都是git命令，对git命令不熟悉的请看这。
首先/geekerprobe这个目录我们是从Octopress的GitHub上clone下来的，所以他本是就是一个git库，可以通过cat .gitignore查看该目录下被排除在git库外的文件以及目录。这些我们在clone之前就已经由作者做好了。我们需要做的是：
git remote add origin [email protected]:username/geekerprobe.git #在远端添加源，origin可以随便写，建议用origin这是默认，后面的路径还是那个 git branch -m site #创建一个分支site，这个site也可以随便写。 # 官方文档使用的是master主分支 git push origin site #将这个源push到site分支中
这样你去你的GitHub上就可以看到你的repo又多了一个site分支，并且有了文件也有版本记录。
这里说一下我理解到的git的简单原理，我也是刚刚接触到git之前都是使用subvision的，通过配置这个blog有了一点体会，但是比较浅显，有不对之处欢迎指出。
在一个git库中会有文件记录你所有对库(working dir)中文件的增删改，类似于svn,可以使用
git status
来查看当前的所有文件改动。之后将显示出来的有改动的文件add到缓冲区(index)，通常我都是
git add .
将所有改动都add到缓冲区，但这只是临时的并没有提交到remote端，也没有被提交到上次提交后的状态下。然后就是将缓冲区的内容提交到上次提交的状态(HEAD)下
git commit -m "something to say"
这些引号中的文字就是类似于svn中的版本改动说明了，现在对文件的改动依然没有提交到remote端。接下来
git push origin site #将HEAD push到remote段
到此本地的版本已经提交到GitHub。
Octopress拓展增强
要想使Octopress拥有更强大的拓展请参考一下文章：
安装主题
自定义样式
添加多说评论
添加标签云与category list