juanito (Juanito Fatas)

Ruby China Emoji 改用 Twitter Emoji 了

juanito — Wed, 15 Jun 2016 19:32:43 +0800

有啥新玩意呢？

六種顏色

一種看起來黃黃的為基準（:base_emoji:），有五種膚色可選（:skin-tone-{2,3,4,5,6}:）。

用法：:base_emoji::skin-tone-N:，N 可以是 2, 3, 4, 5, 6。

男男女女

man, woman, boy, girl 之間可以用 - 組合。大人之間可以談戀愛、心心相映：:man-kiss-man:, :woman-kiss-woman:, :man-heart-man:, `:woman-heart-woman:。

各種旗幟

用法 :flag-C:，C 是兩位的區域代碼。

全部可以到這裡看：https://jollygoodcode.github.io/twemoji

具體實現

https://github.com/ruby-china/ruby-china/pull/677

使用了 https://github.com/jollygoodcode/twemoji 這個 Twemoji RubyGem。

大家給 @huacnlee

Rails 5 系列文章

juanito — Wed, 18 May 2016 16:09:09 +0800

請大家移步這裡：

http://blog.bigbinary.com/categories/Rails-5

新加坡 RedDotRubyConf 2016

juanito — Mon, 15 Feb 2016 13:28:59 +0800

新加坡 RedDotRubyConf，6 月 23 至 24 日，兩天單軌。

已經確定的演講者有：Matz、Aaron Patterson、Terence Lee、Godfrey Chan、Kerri Miller。

開放報名中

CFP 徵稿中（3/28 截止）

Rails & rails-html-sanitizer 安全性更新

juanito — Tue, 26 Jan 2016 11:02:39 +0800

Rails 有 6 個安全性風險

受影響的 Rails 版本：全部！

修復版本

5.0.0.beta1.1
4.2.5.1
4.1.14.1
3.2.22.1

CVE 分別為：

rails-html-sanitizer 有 3 個安全性風險

修復版本

1.0.3

CVE 分別為：

詳見

http://weblog.rubyonrails.org/2016/1/25/Rails-5-0-0-beta1-1-4-2-5-1-4-1-14-1-3-2-22-1-and-rails-html-sanitizer-1-0-3-have-been-released/

參考

https://github.com/rubygems/rubygems.org/pull/1181
使用 RSpec 執行測試遇到未定義 cache 方法，升級 rspec-rails 到 ~> 3.4.1 即可，詳見：https://github.com/rspec/rspec-rails/issues/1532#issuecomment-175116827 。

P.S.

可以用 https://www.deppbot.com 自動幫你升級，請看範例 1、範例 2 😊。

*deppbot 要有 Gemfile + Gemfile.lock 才可用，缺一不可 *

Rails 10 週年：網站改版、新 Logo、書以及視頻

juanito — Wed, 20 Jan 2016 00:37:27 +0800

http://rubyonrails.org 網站新設計（設計師是 Jamie Dihiansan）：

新 logo：

dhh 正在寫一本新書 Ruby on Rails doctrine：

I was going to record a new video for the homepage, but since we're just on the cusp on some changes to Rails 5 that'll change things a bit, I'm holding off until beta2 (which should be out shortly). In the mean time, you can enjoy the introduction to Action Cable. But rest assured that it'll soon be replaced by a new, proper introduction.

dhh 準備重錄一個新視頻來介紹 Ruby on Rails。

Rails 5 新的歡迎頁面，搶先看

Reference: http://weblog.rubyonrails.org/2016/1/19/new-rails-identity/

P.S. 新主頁源碼在：https://github.com/rails/homepage

為什麼要 Bundle Update？

juanito — Sat, 10 Oct 2015 03:46:19 +0800

為什麼要 Bundle Update？

bundle-update(1) 可以更新所有的 Gem 至兼容的最新版本。

首先先說說...

為什麼要升級？

新版本修復了更多 Bugs
新版本效能更好
維護者通常只對新版本的 Bug 感興趣
預防勝於治療
減少技術負債

為什麼 Rails 4 升級至 Rails 5 這麼難？

因為哥你兩年才升級一次，很多 Gem 都太老了，一次全升級，每個 Gem 不兼容一點點，加起來全敗了。

語義化版本

語義化版本定義了一個版本命名的規範，幾乎所有的 RubyGem 都遵循這個規範。

4.2.4 - MAJOR.MINOR.PATCH

MAJOR 版本更新會壞，，向下不相容。 MINOR 版本通常是發佈新功能，向下相容。 PATCH 版本通常是修復 Bugs，向下相容。

rails 4.2.4 升級至 4.2.5，OK！ rails 4.2.4 升級至 4.3.0，Should be OK！ rails 4.2.4 升級至 5.0，break！

了解了語義化版本之後...

Gem 作者不採用語義化版本怎麼辦？

堅決拒用或是說服他！

怎麼鎖定版本號？

有三種鎖定方式：

進擊型 `>=`

>= 2.0 表示 >= 2.0

中庸型 `~>`

~> 2.0 表示 >= 2.0, < 3 ~> 2.0.0 表示 >= 2.0.0, < 2.1

防禦型 `4.2.4`

"4.2.4" gem 版本會固定在 "4.2.4"

鎖定版本號的缺點

當有安全性發佈時，鎖定版本號讓你無法升級至已經修復的版本。

你先前說兼容的最新版本？

Gem 彼此之間有依賴關係，bundle update 會找到你的專案彼此兼容的版本，進行“升級”。

“升級”？

bundle update 不一定會更新到新版...

有可能某個 Gem 會降版，因為 bundle update 要確保所有更新的版本都兼容。

有人說...

Monkey Patch 一下就好了阿

這樣就得自己維護 Gem，時常跟進上游的更新，成本高。

有些東西升級不能壞

鎖定版本號或是升級後，自行檢查並對代碼進行相應的修正。

看你講了這麼多，怎麼 `bundle update`，能示範下不？

$ cd project
$ git cehckout -b bundle-update-20151006
git: 'cehckout' is not a git command. See 'git --help'.

Did you mean this?
  checkout
$ git checkout -b bundle-update-20151006
$ bundle updaet
Could not find command "updaet".
$ bundle update
$ git add Gemfile.lock
$ git comit -m "Bundle update on 2015.10.06"
git: 'comit' is not a git command. See 'git --help'.

Did you mean this?
  commit
$ git commmit -m "Bundle update on 2015.10.06"
git: 'commmit' is not a git command. See 'git --help'.

Did you mean this?
  commit
$ git commit -m "Bundle update on 2015.10.06"
$ git push origin master
Go to GitHub, click "Create Pull Request"
fill in title
fill in description
click "Create Pull Request"

一次大約十分鐘，以我一個時薪 60 美元的程序員來說，成本大約是 10 美元！

等我有空再 `bundle update` 好了

那就是永遠不會升級啦！所以我們要自動讓計算機幫我們做這件事，省時省心省錢。

為什麼要自動化

自動由服務提供 bundle update，提早發現問題。

自動化 bundle 服務

試試看 Gemnasium 現在推出的自動 bundle update 的功能，Pull Request 看起來像是這樣：

哇！不錯哦，乔布斯你怎麼看？

...Yikes！

P.S. Gemnasium 這個單字我老是拼不對！

有沒有好一點的服務？

可以試試看這個服務：https://www.deppbot.com

自動 bundle update 🎩
更新頻率可選：1、3、5、7、14 天 ⌛
適應 Git-Flow（Pull Request 可對 <customized-branch> branch 發送）🔨
美觀實用的 Pull Request 😍
GitHub Compare View 😳
提供 Changelog，什麼是 Changelog？ 🙋

開源項目永遠免費 🍻私有項目僅收 5 美元！

大家都在用（請參考 Contribution Graph） 👬👭

苟日新，日日新，又日新，你今天更新了嗎？

即刻 bundle update ⚡⚡⚡

註 1. 有測試再 bundle update

註 2. 任何建議與反饋歡迎留言

Rails 里四个单字符长的辅助方法 (h, j, l, t)

juanito — Wed, 22 Jul 2015 16:56:28 +0800

Rails 有四个只有一个字符长的辅助方法，发个帖子用来提高新手搜索的成功率。

`h`

ERB::Util#html_escape 的别名，Escape HTML 标签用。

http://api.rubyonrails.org/classes/ERB/Util.html#method-c-html_escape

> h("is a > 0 & a < 10?")
=> is a &gt; 0 &amp; a &lt; 10?

`j`

escape_javascript 的别名，过滤危险 JavaScript 响应用。

http://api.rubyonrails.org/classes/ActionView/Helpers/JavaScriptHelper.html#method-i-escape_javascript

$('#comment-<%= @comment.id %>').html('<%= j render 'form', comment: @comment %>');

`l`

I18n#localize 的别名，本土化时间用。

http://api.rubyonrails.org/classes/AbstractController/Translation.html#method-i-localize

<%= l(Time.current) %>
# => "Wed, 22 Jul 2015 16:35:27 +0800"

`t`

I18n#translate 的别名，查翻译文本用。

http://api.rubyonrails.org/classes/AbstractController/Translation.html#method-i-translate

<%= t("site.title") %>
# => "My Awesome Store"

Ruby 本色 — 31 篇深入理解 Ruby 的博文

juanito — Mon, 01 Jun 2015 23:50:03 +0800

About Idiosyncratic Ruby Ruby is not only optimized for developer happiness, but also for writing one-liners and it is still one of the top choices for code golfers. Ruby's grammar definition is more than 10000 lines long and there is no editor or syntax highlighter that actually highlights Ruby correctly. A lot of them already fail at highlighting strings not created with the usual quotes syntax, but with one of the more than 100 other ways. But: IDIOSYNCRATIC != BAD

[远程] Ruby 中文官网徵求志工

juanito — Tue, 26 May 2015 15:29:31 +0800

职位描述

Ruby 中文官网（zh_cn）的维护工作，工作内容包括持续翻译中文官网；尽速翻译 Ruby 英文网站的内容；审阅有关 Ruby 中文官网的 Pull Request；友善帮助其它的贡献者。本网站内容范围广泛，基本覆盖整个 Ruby 生态圈，在翻译细节和维护上都有很多挑战。

职位要求

精通中文
熟悉英文
具有耐心与细心与责任感
具备良好的团队意识和协作精神，有较强的沟通能力
欢迎应届计算机专业的毕业生，你可以从无到有学习

加分项

Ruby-China 有个人头像
英语四级
有很强的好奇心和学习能力
熟悉 Git 和 GitHub
有个人技术 Blog
参与过开源项目

Ruby 介绍

Ruby 是一种跨平台、面向对象的动态类型编程语言。Ruby 体现了表达的一致性和简单性，它不仅是一门编程语言，更是表达想法的一种简练方式。

待遇

到台北时我私人请你吃饭

福利

快速获得 Ruby 的新动态
与世界各地开发者交流的机会
体验远程工作

投递简历

请先阅读 https://github.com/ruby/www.ruby-lang.org/wiki ，阅读后请留言留下 GitHub 帐号，我再邀请你加入中文翻译团队。

留下 GitHub ID 就可以到这里挑选任务：https://github.com/ruby/www.ruby-lang.org/issues/1074

这波翻译结束后会询问是否有人想要当中文官网的维护者，主要的工作就是像我在 https://github.com/ruby/www.ruby-lang.org/issues/1074 这里这样，引导、提示、合并 Pull Request，以及没人出手时即时翻译新闻！

Active Job 指南译文

juanito — Sat, 18 Apr 2015 22:11:44 +0800

由 Tian Lu 翻譯的 Active Job Basics 可以到這裡閱讀：

http://guides.ruby-china.org/active_job_basics.html

謝謝！

Ruby 2.2 新方法一览

juanito — Sun, 28 Dec 2014 19:02:23 +0800

原文：Ruby 2.2 New Methods by Example 相关帖子：Ruby 2.2 Tips: max (n), max_by (n), min (n), min_by (n) | Ruby China

Object

`Object#itself`

http://www.ruby-doc.org/core-2.2.0/Object.html#method-i-itself

返回对象自身。

> 3.itself
=> 3

Method

`Method#super_method`

http://www.ruby-doc.org/core-2.2.0/Method.html#method-i-super_method

class People
  def greeting
    'Salve'
  end
end

class American < People
  def greeting
    'Hello'
  end
end

> american = American.new
=> #<American:0x007febbe300ff0>

> american.public_method(:greeting).super_method.call
=> 'Salve'

Enumerable

`Enumerable#slice_after`

http://ruby-doc.org/core-2.2.0/Enumerable.html#method-i-slice_after

> pi = Math::PI.to_s.scan(/\d/).map(&:to_i)
=> [3, 1, 4, 1, 5, 9, 2, 6, 5, 3, 5, 8, 9, 7, 9, 3]

> pi.slice_after(&:even?).to_a
=> [[3, 1, 4], [1, 5, 9, 2], [6], [5, 3, 5, 8], [9, 7, 9, 3]]

`Enumerable#slice_when`

http://ruby-doc.org/core-2.2.0/Enumerable.html#method-i-slice_when

> pi = Math::PI.to_s.scan(/\d/).map(&:to_i)
=> [3, 1, 4, 1, 5, 9, 2, 6, 5, 3, 5, 8, 9, 7, 9, 3]

> pi.slice_when { |a, b| a.even? && b.odd? }.to_a
=> => [[3, 1, 4], [1, 5, 9, 2, 6], [5, 3, 5, 8], [9, 7, 9, 3]]

max、max_by、min、min_by these methods accept a argument n, n is how many max (min) numbers you wanna return.

`Enumerable#max`

http://ruby-doc.org/core-2.2.0/Enumerable.html#method-i-max

> [*1..10].max 2
=> [10, 9]

`Enumerable#min`

http://ruby-doc.org/core-2.2.0/Enumerable.html#method-i-min

> [*1..10].min 2
=> [1, 2]

`Enumerable#max_by`

http://ruby-doc.org/core-2.2.0/Enumerable.html#method-i-max_by

> %w[a aa aaa].max_by 2, &:length
=> ["aaa", "aa"]

`Enumerable#min_by`

http://ruby-doc.org/core-2.2.0/Enumerable.html#method-i-min_by

> %w[a aa aaa].min_by 2, &:length
=> ["a", "aa"]

`Float`

`Float#next_float`

http://www.ruby-doc.org/core-2.2.0/Float.html#method-i-next_float

Return next float.

> 3.1415926.next_float
=> 3.1415926000000005

`Float#prev_float`

http://www.ruby-doc.org/core-2.2.0/Float.html#method-i-prev_float

Return previous float.

> 3.1415926.prev_float
=> 3.1415925999999996

`File`

`File.birthtime`

http://www.ruby-doc.org/core-2.2.0/File.html#method-c-birthtime

> File.birthtime 'README.md'
=> 2014-10-04 13:40:29 +0800

`File#birthtime`

http://www.ruby-doc.org/core-2.2.0/File.html#method-c-birthtime

> File.open('README.md') { |file| file.birthtime }
=> 2014-10-04 13:40:29 +0800

`String`

`String.unicode_normalize`、`String.unicode_normalize!`、`String.unicode_normalize?`

对字串进行 Unicode 正规化。

> bad = "¿como\u0301 esta\u0301s?"
=> "¿comó estás?"

> p bad.unicode_normalize
=> "¿comó estás?"

> p bad
=> "¿comó estás?"

> p bad.unicode_normalized?
=> false

> p bad.unicode_normalize!
=> "¿comó estás?"

> p bad
=> "¿comó estás?"

> p bad.unicode_normalized?
=> true

Rails 4.2 发布记

juanito — Mon, 22 Dec 2014 00:01:40 +0800

大家好，

Rails 4.2 release post 翻译好了，请大家去这里阅读 Ruby on Rails 4.2 发布记。

有错误或是修正用语：https://github.com/ruby-china/guides

圣诞节快到了，圣诞快乐！

Rails 中文指南新位置

juanito — Tue, 15 Jul 2014 00:09:58 +0800

贡献到这里：

https://github.com/ruby-china/guides/

阅读看这里：

http://guides.ruby-china.org/

内容来自 @andor_chen 的翻译。请大家支持他的 Rails 指南电子书。

同时感谢 @lgn21st 的协助。

RubyConf Taiwan 2014 汇总

juanito — Sat, 28 Jun 2014 23:14:21 +0800

Keynote

Talks

Lightening Talks

RubyConf Taiwan 2014 照片集锦

会众摄影

插图 by Ashley

用 Benchmark-ips 量测代码效能

juanito — Fri, 13 Jun 2014 17:11:52 +0800

原帖

[benchmark-ips][bips] 是由 Puma 作者 Evan Phoenix（@evanphx）所写的 RubyGem。

安装

$ gem install benchmark-ips

使用方法

首先把库引入，接著用一个 Benchmark.ips do |x| ... end 区块包住要量测的代码，x 实现了一个 report 方法，负责量测代码。

require 'benchmark/ips'

Benchmark.ips do |x|
  x.report("addition") { 1 + 2 }

  x.report("addition2") do |times|
    i = 0
    while i < times
      1 + 2
      i += 1
    end
  end

  x.report("addition3", "1 + 2")
end

report 第一个参数是字串，用来说明量测的是什么。后面放要量测的代码，可以区块、字串形式传入。

原先使用 Ruby 自带的 Benchmark 库，需要预测到底要执行几次，才可以得到信服的结果。

而次数又因各个开发者使用的机器而异。Benchmark-ips 很好的解决了这个问题。

Benchmark-ips 会在 5 秒内尽可能执行代码，告诉你 5 秒内代码可以执行几次（i/s，iteration per second）。

若想更改默认的 5 秒，譬如改成 20 秒：

Benchmark.ips(20) do |x|
  ...
end

上例执行结果：

Calculating -------------------------------------
            addition     72783 i/100ms
           addition2     68922 i/100ms
           addition3     84483 i/100ms
-------------------------------------------------
            addition  5085784.0 (±7.3%) i/s -   25255701 in   4.999724s
           addition2 23843924.9 (±10.0%) i/s -  116960634 in   4.993053s
           addition3 24357200.0 (±7.5%) i/s -  120726207 in   4.997873s

除了排版精美之外，最棒的是会显示标准偏差值，可以更好的了解量测结果。

：）

[bips]: https://github.com/evanphx/benchmark-ips

microrb.com

juanito — Mon, 19 May 2014 03:38:36 +0800

http://microrb.com

列出簡潔、相依少、專一的 RubyGem。

都是「做一件事，把它做好」的 RubyGem，學習 Ruby 的好地方。

研讀源代碼的好去處。

Working with JavaScript in Rails 译文

juanito — Sun, 12 Jan 2014 22:42:14 +0800

原文：http://edgeguides.rubyonrails.org/working_with_javascript_in_rails.html 译文：http://git.io/SCwOuA 欢迎帮我修正用语。

Rails x JavaScript

特别要强调的翻译名词

Web application 应用程序 Request 请求 Vanilla JavaScript 纯 JavaScript

本篇介绍 Rails 自带的 Ajax/JavaScript 功能。让你轻松打造丰富生动的 Ajax 应用程序。

读完你可能会学到...

Ajax 的基础。
Unobtrusive JavaScript (via jQuery-ujs).
如何使用 Rails 内建的 Helpers。
在服务器端处理 Ajax。
Turbolinks。

Ajax 介绍

为了要理解 Ajax，首先要了解浏览器平常的工作原理。

当你在浏览器网址栏输入 http://localhost:3000，并按下回车。浏览器此时（Client）便向服务器发送请求。服务器接受 Request，去拿所有需要的资源（assets）给你，像是 js、css、图片等，接著将这些资源按照程序逻辑组合成网页，再响应给你（Response）。

如果你在网页里按下某个连结，将会重复刚刚的步骤：发送请求、抓取资源、组合页面、返回结果。这几个步骤通常称之为“Request Response Cycle”。

JavaScript 也可向服务器发送请求或是解析 Response。JavaScript 也具有更新网页的能力。熟悉 JavaScript 的开发者可以做到只更新部分的页面，而无需向服务器请求整个页面。

这个强大的技术叫做 Ajax。

Rails 出厂内建 CoffeeScript，故以下的例子皆以 CoffeeScript 撰写。当然，这些例子也可用纯 JavaScript 写出来。

用 jQuery 发送 Ajax 请求的例子：

$.ajax(url: "/test").done (html) ->
  $("#results").append html

这段程序从 /test 获取数据，并将数据附加在 id 为 #results 的元素之后。

Rails 对于使用这种技巧来撰写网页，提供了相当多的官方支援。几乎鲜少会需要自己编这样的程序。以下章节将示范，如何用点简单的技术，Rails 便能帮你写出应用了 Ajax 的网站。

Unobtrusive JavaScript

Rails 使用一种叫做“[Unobtrusive JavaScript][ujs]” （缩写为 UJS）的技术来处理 DOM 操作。这是来自前端社群的最佳实践，但有些教学文件可能会用别种技术，来达成同样的事情。

以下是撰写 JavaScript 最简单的方式（行内 JavaScript）：

<a href="#" onclick="this.style.backgroundColor='#990000'">Paint it red</a>

按下连结，背景就变红。但要是我们有许多 JavaScript 代码，要在按下时执行怎么办？

<a href="#" onclick="this.style.backgroundColor='#009900';this.style.color='#FFFFFF';">Paint it green</a>

尴尬吧？我们可以将 JavaScript 抽离出来，并用 CoffeeScript 改写：

paintIt = (element, backgroundColor, textColor) ->
  element.style.backgroundColor = backgroundColor
  if textColor?
    element.style.color = textColor

接著在页面上：

<a href="#" onclick="paintIt(this, '#990000')">Paint it red</a>

看起来好一点了，但多个连结都要有同样的效果呢？

<a href="#" onclick="paintIt(this, '#990000')">Paint it red</a>
<a href="#" onclick="paintIt(this, '#009900', '#FFFFFF')">Paint it green</a>
<a href="#" onclick="paintIt(this, '#000099', '#FFFFFF')">Paint it blue</a>

不是很漂亮，很冗赘。可以使用事件来简化。给每个连结加上 data-* 属性，接著给每个连结的 click 事件，加上一个 Handler：

paintIt = (element, backgroundColor, textColor) ->
  element.style.backgroundColor = backgroundColor
  if textColor?
    element.style.color = textColor

$ ->
  $("a[data-background-color]").click ->
    backgroundColor = $(this).data("background-color")
    textColor = $(this).data("text-color")
    paintIt(this, backgroundColor, textColor)

<a href="#" data-background-color="#990000">Paint it red</a>
<a href="#" data-background-color="#009900" data-text-color="#FFFFFF">Paint it green</a>
<a href="#" data-background-color="#000099" data-text-color="#FFFFFF">Paint it blue</a>

我们将这个技术称为“Unobtrusive”JavaScript。因为我们不再需要把 JavaScript 与 HTML 混在一起。之后便更容易修改，也更容易加新功能上去，只要加个 data- attribute。将 JavaScript 从 HTML 抽离后，JavaScript 便可透过合并压缩工具，让所有页面可以共用整份 JavaScript。也就是说，只需在第一次戴入页面时下载一次，之后的页面使用快取的文件即可。

Rails 团队强烈建议你用这种风格来撰写 CoffeeScript (JavaScript)。

自带的 Ajax Helpers

Rails 在 View 提供了许多用 Ruby 写的 Helper 方法来帮你生成 HTML。有时候会想在这些元素加上 Ajax，没问题，Rails 会帮助你。

Rails 的“Ajax Helpers”实际上分成 JavaScript 所写的 Helpers，与 Ruby 所写成的 Helpers。

用 JavaScript 写的可以在这找到 [rails.js][rails-js]。

form_for

[form_for][form_for]

帮助你撰写表单的 Helper。接受一个 :remote 选项：

<%= form_for(@post, remote: true) do |f| %>
  ...
<% end %>

会生成出：

<form accept-charset="UTF-8" action="/posts" class="new_post" data-remote="true" id="new_post" method="post">
  ...
</form>

注意 data-remote="true"。有了这个 attribute 之后，表单会透过 Ajax 提交，而不是浏览器平常的提交机制。

提交成功与失败可以透过 ajax:success 与 ajax:error 事件，来附加内容至 DOM：

$(document).ready ->
  $("#new_post").on("ajax:success", (e, data, status, xhr) ->
    $("#new_post").append xhr.responseText
  ).bind "ajax:error", (e, xhr, status, error) ->
    $("#new_post").append "<p>ERROR</p>"

当然这只是个开始，更多可用的事件可在 [jQuery-ujs 的维基页面][jquery-ujs-wiki] 上可找到。

form_tag

[form_tag][form_tag]

跟 form_for 非常类似，接受 :remote 选项：

<%= form_tag('/posts', remote: true) %>

会生成

<form accept-charset="UTF-8" action="/posts" data-remote="true" method="post">
  ...
</form>

link_to

[link_to][link_to]

帮助你生成连结的 Helper。接受一个 :remote 选项：

<%= link_to "a post", @post, remote: true %>

会生成

<a href="/posts/1" data-remote="true">a post</a>

你可以上面 form_for 例子那样，绑定相同的 Ajax 事件上去。来看个例子，假设按个按键，删除一篇文章，提示一些讯息。只需写一些 HTML：

<%= link_to "Delete post", @post, remote: true, method: :delete %>

并写一点 CoffeeScript：

$ ->
  $("a[data-remote]").on "ajax:success", (e, data, status, xhr) ->
    alert "The post was deleted."

就这么简单。

button_to

[button_to][button_to]

建立按钮的 Helper。接受一个 :remote 选项：

<%= button_to "A post", @post, remote: true %>

会生成：

<form action="/posts/1" class="button_to" data-remote="true" method="post">
  <div>
    <input type="submit" value="A post">
    <input name="authenticity_token" type="hidden" value="PVXViXMJCLd717CYN5Ty7/gTLF3iaqPhL33FTeBmoVk=">
  </div>
</form>

由于这只是个 <form>，所有 form_for 可用的东西，也可以应用在 button_to。

服务器端的考量

Ajax 不只是 Client-side 的事，服务器也要出力。人们倾向 Ajax requests 返回 JSON，而不是 HTML，让我们看看如何返回 JSON。

简单的例子

想像你有许多用户，你想给他们显示建立新用户的表单。而 Controller 的 index action：

class UsersController < ApplicationController
  def index
    @users = User.all
    @user = User.new
  end
  # ...

以及 index View (app/views/users/index.html.erb)：

<b>Users</b>

<ul id="users">
  <%= render @users %>
</ul>

<br>

<%= form_for(@user, remote: true) do |f| %>
  <%= f.label :name %><br>
  <%= f.text_field :name %>
  <%= f.submit %>
<% end %>

app/views/users/_user.html.erb Partial：

<li><%= user.name %></li>

index 页面上半部列出用户，下半部提供新建用户的表单。

下面的表单会呼叫 Users Controller 的 create action。因为表单有 remote: true 这个选项，Request 会使用 Ajax Post 到 Users Controller，等待 Controller 回应 JavaScript。处理这个 Request 的 create action 会像是：

# app/controllers/users_controller.rb
# ......
def create
  @user = User.new(params[:user])

  respond_to do |format|
    if @user.save
      format.html { redirect_to @user, notice: 'User was successfully created.' }
      format.js   {}
      format.json { render json: @user, status: :created, location: @user }
    else
      format.html { render action: "new" }
      format.json { render json: @user.errors, status: :unprocessable_entity }
    end
  end
end

注意 respond_to 区块内的 format.js，这是 Cotroller 回应 Ajax Request 的地方。create action 对应 app/views/users/create.js.erb：

$("<%= escape_javascript(render @user) %>").appendTo("#users");

Turbolinks

Rails 4 出厂内建 Turbolinks Gem。

这个 Gem 使用了 Ajax 技术，可以加速页面的渲染。

Turbolinks 工作原理

Turbolinks 给页面上所有的 a 标籤添加了一个 click handler。如果浏览器支援 [PushState][ps]，Turbolinks 会利用 PushState 来改变 URL，发送 Ajax 请求，替换 <body> 的内容。

启用 Turbolinks 只需在 Gemfile 加入：

gem 'turbolinks'

并在 CoffeeScript Manifest 文件（app/assets/javascripts/application.js）里加入：

//= require turbolinks

要给某些 link 禁用 Turbolinks，给该标籤加上 data-no-turbolink attribute 即可：

<a href="..." data-no-turbolink>No turbolinks here</a>.

页面变化的事件

撰写 CoffeeScript 时，通常会想在页面加载时做某些处理，搭配 jQuery，通常会写出像是下面的代码：

$(document).ready ->
  alert "page has loaded!"

而 Turbolinks 覆写了页面加载逻辑，依赖 $(document).ready 的代码不会被执行。必须改写成：

$(document).on "page:change", ->
  alert "page has loaded!"

关于更多细节，其他可以绑定的事件等，参考 Turbolinks 的 README。

其他资源

中文推荐阅读 @Rei 所写的 [Rails 3.2 的 Ajax 向导][rails-3-2-ajax-by-rei]。

了解更多相关内容，请参考以下连结：

[jquery-ujs-wiki]: https://github.com/rails/jquery-ujs/wiki/ajax [ps]: https://developer.mozilla.org/en-US/docs/DOM/Manipulating_the_browser_history#The_pushState.C2.A0method(\) [rails-js]: https://github.com/rails/jquery-ujs/blob/master/src/rails.js [form_for]: http://api.rubyonrails.org/classes/ActionView/Helpers/FormHelper.html#method-i-form_for [form_tag]: http://api.rubyonrails.org/classes/ActionView/Helpers/FormTagHelper.html#method-i-form_tag [link_to]: http://api.rubyonrails.org/classes/ActionView/Helpers/UrlHelper.html#method-i-link_to [button_to]: http://api.rubyonrails.org/classes/ActionView/Helpers/UrlHelper.html#method-i-button_to [ujs]: http://zh.wikipedia.org/zh-cn/Unobtrusive_JavaScript

[rails-3-2-ajax-by-rei]: http://chloerei.com/2012/04/21/rails-3-2-ajax-guide/

Active Model Basics 译文

juanito — Tue, 24 Dec 2013 20:45:25 +0800

原文：http://edgeguides.rubyonrails.org/active_model_basics.html 译文：http://git.io/5G6-uQ 有错误可提高的地方，欢迎给我提 Pull Request。

Active Model 基础

特别要强调的翻译名词

Module 模块

Attribute 属性

本篇教你如何开始使用 Model。Active Model 允许 Action Pack Helpers 与不是 Active Record 的 Model 类别来做交互。Active Model 也允许你在 Rails 框架之外自己造 ORM。

1. 简介

Active Model 是一个函式库，由许多用来与 Action Pack 互动的模块组成。以下简单介绍几个 Active Model 的模块。

1.1 AttributeMethods 模块

用来给方法加上前缀或后缀。

class Person
  include ActiveModel::AttributeMethods

  attribute_method_prefix 'reset_'
  attribute_method_suffix '_highest?'
  define_attribute_methods 'age'

  attr_accessor :age

  private
    def reset_attribute(attribute)
      send("#{attribute}=", 0)
    end

    def attribute_highest?(attribute)
      send(attribute) > 100
    end
end

person = Person.new
person.age = 110
person.age_highest?  # true
person.reset_age     # 0
person.age_highest?  # false

1.2 Callbacks 模块

Active Record 风格的 Callbacks。让我们可以在运行期定义 Callbacks。定义 Callback 后便有 before_*、after_* 与 around_* 方法可用。

class Person
  extend ActiveModel::Callbacks

  define_model_callbacks :update

  before_update :reset_me

  def update
    run_callbacks(:update) do
      # This method is called when update is called on an object.
    end
  end

  def reset_me
    # This method is called when update is called on an object as a before_update callback is defined.
  end
end

1.3 Conversion 模块

如果一个类别有定义 persisted? 与 id 方法，则你可引入 Conversion 模块，并对此类别的对象呼叫 Rails 的 conversion 方法（to_model、to_key、to_param）。

class Person
  include ActiveModel::Conversion

  def persisted?
    false
  end

  def id
    nil
  end
end

person = Person.new
person.to_model == person  # => true
person.to_key              # => nil
person.to_param            # => nil

1.4 Dirty 模块

对象有一个或多个改动，却未储存，则称对象变 dirty 了。这让我们可以检查对象是否有改动。以下是 Person 类别，有 first_name 与 last_name 这两个属性：

require 'active_model'

class Person
  include ActiveModel::Dirty
  define_attribute_methods :first_name, :last_name

  def first_name
    @first_name
  end

  def first_name=(value)
    first_name_will_change!
    @first_name = value
  end

  def last_name
    @last_name
  end

  def last_name=(value)
    last_name_will_change!
    @last_name = value
  end

  def save
    # do save work...
    changes_applied
  end
end

1.4.1 查询对象的变化

person = Person.new
person.changed? # => false

person.first_name = "First Name"
person.first_name # => "First Name"

# returns if any attribute has changed.
person.changed? # => true

# returns a list of attributes that have changed before saving.
person.changed # => ["first_name"]

# returns a hash of the attributes that have changed with their original values.
person.changed_attributes # => {"first_name"=>nil}

# returns a hash of changes, with the attribute names as the keys, and the values will be an array of the old and new value for that field.
person.changes # => {"first_name"=>[nil, "First Name"]}

1.4.2 基于属性的 accessor 方法

检查 first_name 这个属性是否有改动，first_name_changed?：

# attr_name_changed?
person.first_name # => "First Name"
person.first_name_changed? # => true

检查属性上一次的数值：

# attr_name_was accessor
person.first_name_was # => "First Name"

检查属性上次与当前的值，有变化返回 Array，没变化返回 nil：

# attr_name_change
person.first_name_change # => [nil, "First Name"]
person.last_name_change # => nil

1.5 Validations 模块

给类别加入 Active Record 风格的验证功能：

class Person
  include ActiveModel::Validations

  attr_accessor :name, :email, :token

  validates :name, presence: true
  validates_format_of :email, with: /\A([^\s]+)((?:[-a-z0-9]\.)[a-z]{2,})\z/i
  validates! :token, presence: true
end

person = Person.new(token: "2b1f325")
person.valid?                        # => false
person.name = 'vishnu'
person.email = 'me'
person.valid?                        # => false
person.email = 'me@vishnuatrai.com'
person.valid?                        # => true
person.token = nil
person.valid?                        # => raises ActiveModel::StrictValidationFailed

Ruby on Rails 4.1 发布记

juanito — Fri, 20 Dec 2013 01:11:37 +0800

juanito (Juanito Fatas)

Ruby China Emoji 改用 Twitter Emoji 了

六種顏色

男男女女

各種旗幟

具體實現

Rails 5 系列文章

新加坡 RedDotRubyConf 2016

Rails & rails-html-sanitizer 安全性更新

Rails 有 6 個安全性風險

修復版本

rails-html-sanitizer 有 3 個安全性風險

修復版本

詳見

參考

Rails 10 週年：網站改版、新 Logo、書以及視頻

為什麼要 Bundle Update？

為什麼要 Bundle Update？

為什麼要升級？

為什麼 Rails 4 升級至 Rails 5 這麼難？

語義化版本

Gem 作者不採用語義化版本怎麼辦？

怎麼鎖定版本號？

進擊型 >=

中庸型 ~>

防禦型 4.2.4

鎖定版本號的缺點

你先前說兼容的最新版本？

“升級”？

Monkey Patch 一下就好了阿

有些東西升級不能壞

看你講了這麼多，怎麼 bundle update，能示範下不？

等我有空再 bundle update 好了

為什麼要自動化

自動化 bundle 服務

有沒有好一點的服務？

Rails 里四个单字符长的辅助方法 (h, j, l, t)

h

j

l

t

Ruby 本色 — 31 篇深入理解 Ruby 的博文

[远程] Ruby 中文官网徵求志工

职位描述

职位要求

加分项

Ruby 介绍

待遇

福利

投递简历

Active Job 指南译文

Ruby 2.2 新方法一览

Object

Object#itself

Method

Method#super_method

Enumerable

Enumerable#slice_after

Enumerable#slice_when

Enumerable#max

Enumerable#min

Enumerable#max_by

Enumerable#min_by

Float

Float#next_float

Float#prev_float

File

File.birthtime

File#birthtime

String

String.unicode_normalize、String.unicode_normalize!、String.unicode_normalize?

Rails 4.2 发布记

Rails 中文指南新位置

推荐 Ruby ＆ Rails 内部实现文集

Ruby 标准库

元 Ruby

Reading Rails

RubyConf Taiwan 2014 汇总

Keynote

Talks

進擊型 `>=`

中庸型 `~>`

防禦型 `4.2.4`

看你講了這麼多，怎麼 `bundle update`，能示範下不？

等我有空再 `bundle update` 好了

`h`

`j`

`l`

`t`

`Object#itself`

`Method#super_method`

`Enumerable#slice_after`

`Enumerable#slice_when`

`Enumerable#max`

`Enumerable#min`

`Enumerable#max_by`

`Enumerable#min_by`

`Float`

`Float#next_float`

`Float#prev_float`

`File`

`File.birthtime`

`File#birthtime`

`String`

`String.unicode_normalize`、`String.unicode_normalize!`、`String.unicode_normalize?`