安装和设置Git

下载Git for

Windows，采用默认安装，安装完成后就可以在本地使用Git了。

但要将内容放到Github上，必须先在Github网站上注册个账户，然后在本机使用Git创建SSH Key。操作如下：

在Git Bash上输入命令:

ssh-keygen -C "[email protected]" -t rsa

Note: “[email protected]”需要更换成你在Github上注册的Email地址或者是Username

这样会在用户目录(C:\Users\用户名)下产生一个.ssh文件夹，里面为对应的SSH

Keys，其中id_rsa.pub是Github需要的SSH公钥文件。

到c:\Users\用户名\.ssh\目录找到id_rsa.pub（可能位置不一定对，但是确认是以.pub结尾的文件），并用记事本打开复制全部内容。

Note：建议私钥公钥的名称最好写成"id_rsa"，这样连接Github的时候会找这个文件，如果文件名已定，之后改名也行。

在github网站选择“Account Settings”>>“SSH Public Keys”>>“Add another

public key”，将刚才复制的内容粘贴到key文本框内。

这样就可以直接使用Git和GitHub了。

Note：建议在Git Bash中输入“ssh -v [email protected]”测试能够正常连接github

安装Ruby环境

下载RubyInstaller和DevKit。

因为Octopress需要的Ruby版本为1.9.2，所以选rubyinstaller-1.9.2-p290.exe，DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe。

先安装RubyInstaller，然后解压缩DevKit(路径中不能有中文)。

在“Start Command Prompt with Ruby”命令行中进入DevKit解压缩的目录，然后运行以下命令:

ruby dk.rb init

ruby dk.rb install

gem install rdiscount --platform=ruby

如果安装成功，就可以使用一些Ruby的工具了，也为后面搭建博客提供了基础环境。

安装Octopress

先通过Git从Github上克隆一份Octopress（在Git Bash上输入命令）

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

然后安装一些依赖的工具（后面都是在Start Command Prompt with Ruby中输入）

cd octopress

ruby --version # Should report Ruby 1.9.2

gem install bundler

bundle install

安装Octopress默认的Theme

rake install

配置Octopress

将octopress的文件夹下的_config.yml的编码改成UTF-8：

保存（或另存为）时选择编码格式为UTF-8

修改_config.yml，批改url、title、subtitle、author等等。

到Ruby的安装目次\lib\ruby\gems\1.9.1\gems\jekyll-0.11.2\lib\jekyll\找到convertible.rb这个文件，批改self.content

= File.read（File.join（base， name））为self.content = File.read（File.join（base，

name）， :encoding =>"utf-8"）。

写博文

最简单的方式：复制octopress\source\_posts下某个文件，例如2012-07-30-the-first-post.markdown，修改文件名和文件中的内容

或者，命令行中输入rake

new_post["title"]，会创建一个新的Post，新文件在source/_post下，文件名如下面的格式:2012-07-31-title.markdown。该文件可以直接打开修改。

写文章时，可以使用Markdown和Octopress

Plugins等工具对内容进行格式排版。

预览效果

在修改设置或者写完文章后，想看看具体效果，可以通过如下命令来完成:

rake generate

rake preview

将博客部署到Github上

在预览的效果符合自己的预期后，就可以通过如下命令将内容部署到Github上了。

如果是第一次部署，需要在Github上创建一个username.github.com的repository

在github网站选择“Create a New Repo”,如图

填写对应的内容即可

note：Repository

name填写username.github.com，username一定要和github的username一致，建好的博客代表的是你这个github账户的主页即page

配置octopress与github的连接：

进入Octopress目录：

rake setup_github_pages

按照提示填入你的github项目网址，比如：

[email protected]:Username/yourname.github.com.git

note：可以按照上面的修改，也可以在github的项目页中找地址

分发到github上：

rake deploy

第一次运行时，会询问是否建立对github的授权，输入：yes。然后将站点更新的内容推送到github上。

补充一点：

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

git status

git add .

git commit -m 'your message'

git push origin source

大功告成！

1、找到下面这个文件 C:\Ruby21-x64\lib\ruby\gems\2.1.0\gems\sass-3.4.8\lib\sass\engine.rb

2、找到require 'sass/supports'这一行，在下面一行添加Encoding.default_external = Encoding.find('utf-8')

有很多人对 Rails 感兴趣，但又不知道从何下手、学习路线是什么，因为在多个场合下回答过类似问题，所以决定整理成文章供大家参观。

有很多人选择直接学习 Rails，在学习使用 Rails 的过程中学习 Ruby。但我觉得这有些本末倒置，我更推崇先学 Ruby 再学 Rails，在对 Ruby 有了一定的了解后再学 Rails 有事半功倍的效果，同时也不会那么有挫败感。

另外，不管你之前是否有过其它编程语言（如 Java、php 等）的经验，都可以直接学 Ruby 编程语言。

废话有些多，下面列出一些指南，注：本文写于 2011 年 11 月 4 日，并于 2014 年 8 月 8 日更新，所有软件版本都以该日为准。

开发平台选择

Mac >Linux >Windows

如果可以，最好不要在 Windows 下折腾 Rails，你会浪费大量时间在解决一些莫名其妙的问题上，而这些问题可能永远不会在 Linux 或 Mac 下出现。

开发工具选择

Mac 下首推 Textmate，因为免费；其次 Sublime Text 3；再次 Macvim，最后是一个 IDE Rubymine。

Linux 和 Windows 下推荐 Sublime Text 3 或 vim，也可以使用 Rubymine。

Ruby 版本选择

推荐 Ruby 2.1.x，备选 Ruby 2.0.x

Rails 版本选择

推荐 Rails 4.1.x，也就是目前的最新版（Rails 4.1.4），因为 Rails 更新非常快，且从不向下兼容，所以我推荐新手直接学最新版。

Ruby 及 Rails 组合推荐

Ruby 2.1 + Rails 4.1.x，备选：Ruby 2.0.x + Rails 4.0.x

版本控制系统选择

大家可能更熟悉 cvs 或 SVN，但在这我推荐使用 Git，可以看《Pro Git》（中文）或《Git Community Book 中文版》。

书籍推荐

先学 Ruby 推荐看《Programming Ruby 1.9 &2.0》(目前只有英文版)，需要中文书的话，可以看《Ruby基础教程（第4版）》。

再学 Rails 看《Ruby on Rails Tutorial Learn Rails by Example》(中文版地址)

Ruby 进阶看《The Well-Grounded Rubyist》，Rails 进阶看《The Rails 4 Way》

注：上面有提到，因为 Rails 更新非常快，且不向下兼容，同时中文翻译引进本来就慢，所以导致 Rails 的简体中文资料严重滞后，不推荐阅读。

注：推荐《Ruby on Rails Tutorial Learn Rails by Example》而不是《Agile Web Development With Rails》第 4 版的原因是，我个人觉得前者写的更好更简单易懂。

补充几本繁体中文的书《Ruby on Rails 实战圣经》(还未更新到 rails 4)《Rails 101 - 火速学会 Ruby on Rails》《笨方法学 Ruby》做参考。

必看资料

Rails 官方出的 Guide，英文，会不断更新，内容详实，必看。也可以看中文版，国人同步翻译。

开发环境搭建

Mac 用户可以看「Install Ruby on Rails - Mac OS X」一文，会不断更新。

Linux 用户可以看「Install Ruby on Rails - Ubuntu」一文，会不断更新。

以上两个安装教程非常完善和全面，会让你少踩很多地雷，推荐，虽然是英文的。

如果你英语实在不行，那请阅读 Ruby China 上的「如何快速正确的安装 Ruby, Rails 运行环境」一文。

如果你使用 Windows 操作系统，请使用「RailsInstaller 一键安装包」。

再次提醒，除非迫不得已，请不要在 Windows 下折腾 Rails。

推荐站点

1，Ruby China http://ruby-china.org，目前国内人气比较不错的一个 ruby 和 rails 相关的社区，推荐经常上去逛逛。尤其是 Wiki 部分 更应该多看看，都是非常棒的资料。

2，“Crazy Deep” Rails Examples and Tutorials，如果英语尚可，也推荐经常阅读，这里面有很多非常有用的链接和教程，包括搭建环境等，定期更新，推荐。