Ruby 是一门免费的、简单的、直观的、可扩展的、可移植的、解释的脚本语言，用于快速而简单的面向对象编程。类似于 Perl，它支持 处理文本文件和执行系统管理任务的很多特性。

Rails 是用 Ruby 编写的一款完整的、开放源代码的 Web 框架，目的是使用更简单而且更少的代码编写实际使用的应用程序。

作为一个完整的框架，这意味着 Rails 中的所有的层都是为协同工作而构造的，所以您不必自己再重复，可以完全只使用一门单一的语言。 在 Rails 中，所有内容（从模板到控制流再到业务逻辑）都是用 Ruby 编写的。Rails 支持基于配置文件和注释的反射（reflection）和运行时扩展。

本文详细介绍了 Rails 的组成部分，并介绍了它的工作原理。

Rails 介绍

关于 Rails，首先需要理解的是它的模型/视图/控制器（model/view/controller，MVC）架构。虽然这种技术不是 Rails 所特有的 —— 甚至不是 Web 应用程序所特有的（相对于其他程序），但是 Rails 具有非常清晰而专一的 MVC 思维方式。如果您并不使用 MVC 方法，那么 Rails 的用处将大为降低（与遵循其模式的情况相比）。

模型

Rails 应用程序的模型部分主要是它所使用的底层数据库。实际上，在很多情形中 Rails 应用程序正是以一种受管理的方式对关系型数据库管理 系统（RDBMS）中的数据执行操作的一个途径。

ActiveRecord 类是 Rails 的一个核心组成部分，它将关系型表映射为 Ruby 对象，使其成为控制器可以操作并能在视图 中显示的数据。Rails 应用程序特别倾向于使用广为应用的 MySQL 数据库，不过也有与很多其他 RDBMS 的绑定，比如 IBM? DB2?。

如果您愿意，您可以添加 Ruby 代码来在应用程序模型中执行额外的验证，加强数据关联，或者触发其他操作。应用程序的 app/models/ 目录中的 Ruby 文件能够调用 ActiveRecord 的多种验证方法。不过，您也可以将模型代码留作一个存根，而只是依赖保存数据 的 RDBMS 的约束。例如，我在这个示例中所开发的应用程序只包含这个骨架模型代码（至少在开始时是）：

清单 1. 骨架模型 app/models/contact.rb

class Contact <ActiveRecord::Base

end

控制器

控制器以其抽象形式执行应用程序的逻辑。也就是说，应用程序的 app/controllers/ 目录中的 Ruby 脚本能把模型数据导入为变量，保存回去，或对其进行修改 和处理。不过，控制器不关心用户如何适当地显示或者输入数据。在通常的 MVC 模型中，这可以让用户能够以多种方式与同一控制器进行交互：本地 GUI， Web 界面，以及视力较弱的人使用的语音界面都可以与相同的控制器进行交互。

不过，Rails 不像那样非常通用；相反，它仅局限于在 Web 页中提供和收集数据。虽然如此，但是您可以修改那些 Web 页的布局 —— 颜色、字体、表格、 样式表单，等等 —— 与控制器代码无关。

视图

Rails 视图是我们编写 Ruby 代码的地方。Rails 包含有一门用于 .rhtml 的非常好的模板语言，它将纯粹的 HTML 与嵌入的 Ruby 代码组合起来。 Rails 应用程序界面的最表层外观通常是由 CSS 样式表单控制的。.rhtml 格式是一种增强的 HTML。实际上，一个简单的 HTML 文件本身也是一个 合法的 RHTML 模板，不过，不应该忽略 RHTML 为您提供的脚本控制。

RHTML 是真正的模板格式 —— 不仅是在 HTML 中嵌入代码的方式 —— 这是一种更为有效的方法。如果您熟悉 PHP，那么可以考虑 PHP 本身与 Smarty 模板之间的对照。也就是说，嵌入的脚本只是将代码与未被解释的 HTML 混合在一起；当需要向客户机输出某些内容时，代码部分 仍要负责执行 print 语句。

与之不同的是，模板引擎向 HTML 添加了一组定制的标签，让您能够将条件、循环以及其他逻辑作为增强的 HTML 标记的一部分来表示。

回页首

生成代码

Rails 所提供的工具主要是一组代码生成器。相对于那些强迫我使用严格的工作空间和 IDE 的开发环境，我更喜欢这种方法。 Rails 不会妨碍您，但是却会为您省去大部分手工编程的工作 —— 或者，通过提供“可自由获得的”初步（first-pass）支架（scaffolding）， 至少帮助您轻松将需要手工编码的工作分为多个部分。

支架 概念是 Rails 中的核心概念。非常简单的应用程序可能完全不用编码，让 Rails 在运行时动态地生成客户机 HTML 页面。 第一遍生成代码时创建的只是粗略的支架；接下来您可以生成更详细的能够定制的控制器、视图和模型。不过在开始时不需要生成太多。

Rails 对其文件的组织是固定的而且非常普通的，不过这种组织相对严格。如果您试图强行使用其他文件和代码组织方式，那么您可能得 付出努力去修改 Rails 环境。再者说，我找不到不使用 Rails 所提供的组织方式的理由；在大部分情况下，它“fits your brain”（Ruby 的 支持者喜欢这样讲）。例如，如果您从头开始设计一个框架（至少如果您以“Ruby 方式”思考），那么这些目录名称及其组织可能与您的选择非常接近。

回页首

构建一个简单的应用程序

在 Ruby on Rails Web 站点上有一些教程，可以完整地引导您创建一个简单的 Rails 应用程序（见 参考资料）。 这里的示例程序与之类似，因为正确开始构建 Rails 应用程序的方式是确定的。由于此介绍的长度相对较短，所以我 极力 推荐 那些较长的教程中的一篇，以使得您能够打好更为全面的基础。

示例应用程序是一个基本的通讯录。它演示了创建应用程序的一般步骤：

生成模型（在此步骤中创建 MySQL 数据库和表）。

生成应用程序（包括生成基本代码和目录）。

启动 Rails（并配置数据库的访问）。

创建一些内容（包括生成支架模型和控制器，并告知控制器去使用那个支架）。

我们将详细研究每一个步骤。

生成 AddressBook 模型

对于任何应用程序，您需要做的第一件事情是为它创建一个存放数据的数据库。技术上这个步骤不必最先进行，不过需要在早期完成；应该在编写任何 应用程序代码（甚至是自动生成的代码）之前创建数据库，这应该是显然的。所以，让我们在 MySQL 数据库中创建一个数据库，并在此数据库中创建第一张表。 （阅读其他文档以了解如何安装运行 MySQL 或其他 RDBMS。）

我们假定 MySQL 已经安装并且可用。

清单 2. 创建 MySQL 数据库和表

[~/Sites]$ cat AddressBook.sql

CREATE DATABASE IF NOT EXISTS AddressBook

USE AddressBook

CREATE TABLE IF NOT EXISTS contacts (

id smallint(5) unsigned NOT NULL auto_increment,

name varchar(30) NOT NULL default '',

created_on timestamp(14) NOT NULL,

updated_on timestamp(14) NOT NULL,

PRIMARY KEY (id),

UNIQUE KEY name_key (name)

) TYPE=MyISAM COMMENT='List of Contacts'

[~/Sites]$ cat AddressBook.sql | mysql

在这第一张表中有些地方需要注意。最重要的是每一张表都必须拥有一个 id 列，列名称就是 id。Rails 使用 主键列 id 来完成各种记录保持和引用任务。域 created_on 和 updated_on 是不需要的，不过，如果您使用了它们，那么 Rails 会自动地“在后台”维护它们；在大部分情况下使用这些时间戳没有什么不好。所以，您还要添加的“真正” 数据就只是通讯录内容的名称。

另一个稍微古怪的方面是，Rails 为不同的内容使用单数和复数的名称。根据上下文，各种条目会被重命名为单数或复数形式。表的名称应该使用复数格式。 我没有使用不规则复数单词的经验；datum 和 data 等单词可能会令 Rails 出现问题。

生成 AddressBook 应用程序

既然已经拥有了一个能够交互的数据库，就可以创建 AddressBook 应用程序了。第一个步骤是简单地运行 rails 来生成基本目录和支架代码：

清单 3. 生成基本代码和目录

[~/Sites]$ rails AddressBook

create

create app/apis

create app/controllers

create app/helpers

create app/models

create app/views/layouts

create config/environments

create components

[...]

create public/images

create public/javascripts

create public/stylesheets

create script

[...]

create README

create script/generate

create script/server

[...]

我删减了运行 rails 的输出；所忽略了那些行只是提醒您已经创建的各种文件和目录。在您的系统上试运行它，浏览生成的所有文件。 我已经在代码中显示了一些最重要的文件和目录。

运行 Rails

创建了 AddressBook/ 目录和所需要的子目录后，您需要执行一次惟一的初始配置。首先，通过修改 YAML 配置文件来设置数据库，如下：

清单 4. 配置数据库访问

[~/Sites]$ cd AddressBook

[~/Sites/AddressBook]$ head -6 config/database.yml # after editing

development:

adapter: mysql

database: AddressBook

host: localhost

username: some_user

password: password_if_needed

最后，您需要提供数据。Rails 附带了它自己的单一功能的 Web 服务器，即 WEBrick，非常适用于我们的试验。您可能也会遵循 Ruby on Rails Web 站点上的说明来配置 Apache 或者其他服务器，以通过 FCGI（或者普通的 CGI，但是普通的 CGI 将会较慢）向 Rails 应用程序提供服务。

清单 5. 启动 WEBrick 服务器

[~/Sites/AddressBook]$ ruby script/server -d

=>Rails application started on http://0.0.0.0:3000

[2005-03-21 17:57:38] INFO WEBrick 1.3.1

[2005-03-21 17:57:38] INFO ruby 1.8.2 (2004-12-25) [powerpc-darwin7.8.0]

创建一些内容

要在 WEBrick 端口上看到一个欢迎页面，先前的步骤就足够了。例如，在我的本地系统中，现在可以访问 http://gnosis-powerbook.local:3000/。不过，为了操作定制数据库，需要 生成稍微多一些代码。可以使用脚本 generate 来完成此任务， 这个脚本创建在 AddressBook/ 应用程序目录中：

清单 6. 支架模型和控制器代码的生成

[~/Sites/AddressBook]$ ruby script/generate model contact

exists app/models/

exists test/unit/

exists test/fixtures/

create app/models/contact.rb

create test/unit/contact_test.rb

create test/fixtures/contacts.yml

[~/Sites/AddressBook]$ ruby script/generate controller contact

exists app/controllers/

exists app/helpers/

create app/views/contact

exists test/functional/

create app/controllers/contact_controller.rb

create test/functional/contact_controller_test.rb

create app/helpers/contact_helper.rb

注意，在相应的表名中，这里应该使用单数的 contact，而不是复数的 contacts。

现在需要编辑一个或多个生成的文件（只需稍加编辑）来让控制器去使用支架：

清单 7. 告知控制器去使用支架

[~/Sites/AddressBook]$ cat app/controllers/contact_controller.rb

class ContactController <ApplicationController

model :contact

scaffold :contact

end

HTTP协议基础:

下面列出了 HTML 定义的元素集。点击链接即可前往元素的定义，其中包含了该元素的所有成员集。

对象

a 标明超链接的起始或目的位置。

acronym 标明缩写词。

address 特定信息，如地址、签名、作者、此文档的原创者。

applet 在页面上放置可执行内容。

area 定义一个客户端图像映射中一个超级链接区域的形状、坐标和关联 URL。

b 指定文本应以粗体渲染。

base 指定一个显示 URL 用于解析对于外部源的链接和引用，如图像和样式表。

baseFont 设置渲染文本时作为缺省字体的基础字体值。

bdo 允许作者为选定文本片断禁用双向法则。

bgSound 允许页面带有背景声音或创建音轨。

big 指定内含文本要以比当前字体稍大的字体显示。

blockQuote 设置文本中的一段引语。

body 指定文档主体的开始和结束。

br 插入一个换行符。

button 指定其中所含的 HTML 要被渲染为一个按钮。

caption 指定表格的简要描述。

center 将后面的文本和图像居中显示。

cite 用斜体显示标明引言。

code 指定代码范例。

col 指定基于列的表格缺省属性。

colGroup 指定表格中一列或一组列的缺省属性。

comment 标明不可见的注释。

custom 代表了一个用户自定义元素。

dataTransfer 提供了对于预定义的剪贴板格式的访问，以便在拖曳操作中使用。

dd 在定义列表中表明定义。定义通常在定义列表中缩进。

del 表明文本已经从文档中删除。

dfn 表明术语的定义实例。

dir 引起目录列表。

div 指定渲染 HTML 的容器。

dl 引起定义列表。

dt 在定义列表中表明定义术语。

em 强调文本，通常以斜体渲染。

embed 允许嵌入任何文档。

fieldSet 在字段集包含的文本和其它元素外面绘制一个方框。

font 指定用于渲染所包含文本的新字体、大小和颜色。

form 指定所包含控件在表单中起作用。

frame 在 FRAMESET 元素内指定单个框架。

frameSet 指定一个框架集，用于组织多个框架和嵌套框架集。

head 提供了关于文档的无序信息集合。

hn 以标题样式渲染文本。

hr 绘制水平线。

html 表明文档包含 HTML 元素。

HTML 注释 避免任何内含文本或 HTML 源代码被处理并在浏览器窗口中显示。

i 指定文本应以斜体渲染，若可用的话。

iframe 创建内嵌浮动框架。

img 在文档中嵌入图像或视频剪辑。

IMPORT 从元素行为中导入标签定义。

input 创建各种表单输入控件。

input type=button 创建按钮控件。

input type=checkbox 创建复选框控件。

input type=file 创建文件上载控件，该控件带有一个文本框和一个浏览按钮。

input type=hidden 传输关于客户/服务器交互的状态信息。

input type=image 创建一个图像控件，该控件单击后将导致表单立即被提交。

input type=password 创建与 INPUT type=text 控件类似的单行文本输入控件，不过其中并不显示用户输入的内容。

input type=radio 创建单选钮控件。

input type=reset 创建一个按钮，该按钮单击后将重置表单控件为其缺省值。

input type=submit 创建一个按钮，该按钮单击后将提交表单。

input type=text 创建一个单行的文本输入控件。

ins 指定被插入到文档中的文本。

isIndex 使浏览器显示一个对话框，提示用户输入单行文本。

kbd 以固定字体渲染文本。

label 为页面上的其它元素指定标签。

legend 在 fieldSet 对象绘制的方框内插入一个标题。

li 引起列表中的一个项目。

link 允许当前文档和外部文档之间建立连接。

listing 以固定字体渲染文本。

map 包含客户端图像映射的坐标数据。

marquee 创建一个滚动的文本字幕。

menu 创建一个项目的无序列表。

meta 向服务器和客户端传达关于文档的隐藏信息。

noBR 不换行渲染文本。

noFrames 包含对于那些不支持 FRAMESET 元素的浏览器使用的 HTML。

noScript 指定要在不支持脚本的浏览器显示的 HTML。

object 向 HTML 页面中插入对象。

ol 绘制文本的编号列表。

optGroup 允许作者对 select 元素中的选项进行逻辑分组。

option 引起 SELECT 元素中的一个选项。

p 引起一段。

param 设置 APPLET、EMBED 或 OBJECT 元素的属性初始值。

plainText 以固定宽度字体渲染文本，不处理标签。

pre 以固定宽度字体渲染文本。

q 分离文本中的引语。

rt 指明 RUBY 元素的注音文本。

ruby 指明要放置在文本串之上或内嵌的注解或发音指南。

s 以删除线字体渲染文本。

samp 指定代码范例。

script 为脚本指定由脚本引擎解释的脚本。

select 引起列表框或下拉框。

small 指定内含文本要以比当前字体稍小的字体显示。

span 指定内嵌文本容器。

strike 以删除线字体渲染文本。

strong 以粗体渲染文本。

style 指定页面的样式表。

sub 指定内含文本要以下标的形式显示，通常比当前字体稍小。

sup 指定内含文本要以上标的形式显示，通常比当前字体稍小。

table 指定所含内容要组织成行列的表格。

tBody 指明行作为表格主体。

td 指定表格中的单元格。

textArea 指定多行文本输入控件。

tFoot 指明行作为表尾。

th 指定标题列。标题列将在单元格中居中并以粗体显示。

tHead 指明行作为表头。

title 包含文档的标题。

tr 指定表格中的一行。

tt 以固定宽度字体渲染文本。

u 带下划线渲染文本。

ul 绘制文本的项目符号列表。

var 定义编程变量。通常以斜体渲染。

wbr 向一块 NOBR 文本中插入软换行。

xml 在 HTML 页面上定义一个 XML 数据岛。

xmp 以固定宽度字体渲染作为示例的字体。

安装和设置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

大功告成！