5-Step搭建博客

涉及的技术与工具：

• Octopress
• Git,GitHub
• Ruby,Rails

这些技术，除了Ruby与Git较为熟悉，其他的我也仅知皮毛。但没关系，这些链接是给喜欢深入钻研技术的人研究之用，如果仅仅想拥有一个独立blog，可以略过。

为了应用更加普遍，以下操作在WIN7下进行(实际上推荐Unix和Linux环境)。

下面正式开始：

第一步：

首先，需要注册GitHub，注册完成后，GitHub提供了一套基本的git操作入门教程。请照着做一遍，截图很详细，讲解很清晰。

注意：如果git命令出现以下错误：

ssh: connect to host github.com port 22: Bad file numberfatal: The remote end hung up unexpectedly

说明你的22端口被占用或阻止，请在C:\Users\USERNAME\.ssh\下新建一个config文件，在里面写入：

Host github.comUser [e-mail] 443Hostname ssh.github.com

请把[e-mail]换成你的GitHub注册邮箱。

第二步：

若认真完成第一步之后，应该已经安装好了git与github的环境，甚至知道怎么上传源代码了呢 :)。那么第二步主要针对Ruby环境了，请点击下载rubyinstaller与DevKit。先安装rubyinstaller，各种下一步即可。然后解压DevKit(路径不能有中文)例如解压到F:\DevKit下。然后进入Git Bash，输入(每输一行请回车，后文不再说明):

cd f:/DevKitruby dk.rb initruby dk.rb installgem install rdiscount --platform=ruby

若安装成功，则Ruby环境搭建完成。

第三步：

重头戏来了，安装Octopress框架，还是以F:下为例，进入Git Bash，输入：

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

注意：若这一步下载失败(显示fatal: unable to connect to github.com)

请换为以下命令：

git clone https://github.com/imathis/octopress.git octopress

继续，安装一些重要工具：

cd octopressruby --version # Should report Ruby 1.9.2gem install bundlerbundle installrake install

注意：上述安装如果出现fatal或error，请检查第二步中ruby的版本是否为1.9.2，如果是最新的1.9.3版本，可能会出现一些冲突。如果出现，请将bundle install换成bundle update。

第四步:

到此为止，在本地就可以看到blog的雏形了，我们简单写一篇blog试试，输入：

rake new_post["the first blog"]

在octopress/source/_post目录下可以看到生成了一个这样形式的文件：2012-04-22-the-first-blog.markdown。markdown格式是当下很流行的一种轻量级标记语言，请看这里的详细介绍。可用记事本打开生成的markdown文件，也可以尝试用dillinger工具来写一篇简单的博文。

好了，在本地预览一下效果吧：

rake generaterake preview

成功之后，在浏览器中输入http://localhost:4000/看看，是不是看见一个示例的blog了？

注意：上述过程中可能会出现GBK编码错误，请打开Ruby的安装路径，例如我安装在了F:盘下。寻找以下文件

F:\Ruby192\lib\ruby\gems\1.9.1\gems\jekyll-0.11.0\lib\jekyll\convertible.rb

将第29行的

self.content = File.read(File.join(base, name))

改为

self.content = File.read(File.join(base, name), :encoding => "utf-8")

第五步：

最后一步，要把本地文件部署到GitHub服务器上去。首先需要申请一个自己喜欢的二级域名:

1. 登录GitHub，点击右上角的Create a New Repo。
2. 在Repository name中写下yourname.github.com，其中yourname你起。
3. 点击Create repository，创建完成。

打开Git Bash，进入octopress路径下：

rake setup_github_pages

然后填入[e-mail]:pezy/pezy.github.com.git，这句话来自下图所示:

注意：如果此步出现警告，请参考这个解决方法；然后敲入发布命令：

rake deploy

最后别忘了提交源代码：

git add .git commit -a -m 'comment'git push origin source

好了，等上一杯咖啡的时间，再打开yourname.github.com看看，是否已经成功了呢？

五步之后：

这仅仅是一个开端，后续的一切需要自己摸索，但是就算是这样默认的主题，已经很不错了。再做几个提示吧：

• 修改主页基本信息 - 请打开octopress\_config.yml，可以在里面进行配置。切忌，每项信息前有一个空格。
• 做一些基本的修饰 - 请参考官方文档。
• 每次提交新文章的步骤 - 在本地预览请重复第四步，修改满意了，请重复第五步(从发布命令开始)即可。
• 侧边栏的新浪微博咋加 - 参考这里。
• 博客文章的分享咋弄的 - 参考这里，在最后那部分。
• 那个评论是怎么加上的 - 参考这里。
• 我想让博客脱胎换骨！ - 参考这里。

好了，更多的新奇让咱们共同去探索吧！如有疑问，请留言！

Free Blog, Just Enjoying!

额外的探索:

关于如何嵌入代码，可以看一楼的评论。

另外标签云的做法参考了一个日本人的博客,方法很简单，看代码就能看懂。可在这里直接下载代码。

参考资料：

[1] 思考的轨迹

[2] 程序猎人的博客

[3] Sinosmond’s Blog

[4] Blog of GangMax

[5] Octopress help

[6] T.I.D.

转自：http://pezy.me/blog/2012/04/22/5-step-to-blog/