sinatra 1.4.5 → 1.4.6

data/README.zh.md

@@ -22,7 +22,15 @@ gem install sinatra
 ruby myapp.rb
 ~~~~
 
-在该地址查看： [localhost:4567](http://localhost:4567)
+在该地址查看： http://localhost:4567
+
+这个时候访问地址将绑定到 127.0.0.1 和 localhost ，如果使用 vagrant 进行开发，访问会失败，此时就需要进行 ip 绑定了：
+
+~~~~ shell
+ruby myapp.rb -o 0.0.0.0
+~~~~
+
+```-o``` 这个参数就是进行 Listening 时候监听的绑定，能从通过 IP、127.0.0.1、localhost + 端口号进行访问。
 
 安装Sintra后，最好再运行`gem install thin`安装Thin。这样，Sinatra会优先选择Thin作为服务器。
 
@@ -70,8 +78,8 @@ end
 ~~~~ ruby
 get '/hello/:name' do
   # 匹配 "GET /hello/foo" 和 "GET /hello/bar"
-  # params[:name] 的值是 'foo' 或者 'bar'
-  "Hello #{params[:name]}!"
+  # params['name'] 的值是 'foo' 或者 'bar'
+  "Hello #{params['name']}!"
 end
 ~~~~
 
@@ -83,25 +91,25 @@ get '/hello/:name' do |n|
 end
 ~~~~
 
-路由范式也可以包含通配符参数， 可以通过`params[:splat]`数组获得。
+路由范式也可以包含通配符参数， 可以通过`params['splat']`数组获得。
 
 ~~~~ ruby
 get '/say/*/to/*' do
   # 匹配 /say/hello/to/world
-  params[:splat] # => ["hello", "world"]
+  params['splat'] # => ["hello", "world"]
 end
 
 get '/download/*.*' do
   # 匹配 /download/path/to/file.xml
-  params[:splat] # => ["path/to/file", "xml"]
+  params['splat'] # => ["path/to/file", "xml"]
 end
 ~~~~
 
 通过正则表达式匹配的路由：
 
 ~~~~ ruby
-get %r{/hello/([\w]+)} do
-  "Hello, #{params[:captures].first}!"
+get /\A\/hello\/([\w]+)\z/ do
+  "Hello, #{params['captures'].first}!"
 end
 ~~~~
 
@@ -119,7 +127,7 @@ end
 
 ~~~~ ruby
 get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
-  "你正在使用Songbird，版本是 #{params[:agent][0]}"
+  "你正在使用Songbird，版本是 #{params['agent'][0]}"
 end
 
 get '/foo' do
@@ -254,13 +262,13 @@ set :public_folder, File.dirname(__FILE__) + '/static'
 set :views, File.dirname(__FILE__) + '/templates'
 ~~~~
 
-请记住一件非常重要的事情，你只可以通过符号引用模板， 即使它们在子目录下
-（在这种情况下，使用 `:'subdir/template'`）。 你必须使用一个符号，
-因为渲染方法会直接地渲染任何传入的字符串。
+重要提示：你只可以通过符号引用模板， 即使它们在子目录下
+（在这种情况下，使用 `:'subdir/template'`）。 如果你不用符号、而用字符串的话，
+填充方法会只把你传入的字符串当成内容显示出来，而不调用模板。
 
 ### Haml模板
 
-需要引入 `haml` gem/library以渲染 HAML 模板：
+需要引入 `haml` gem/library以填充 HAML 模板：
 
 ~~~~ ruby
 # 你需要在你的应用中引入 haml
@@ -271,7 +279,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.haml`。
+填充 `./views/index.haml`。
 
 [Haml的选项](http://haml.info/docs/yardoc/file.HAML_REFERENCE.html#options)
 可以通过Sinatra的配置全局设定， 参见
@@ -301,7 +309,7 @@ end
 
 ### Erubis
 
-需要引入 `erubis` gem/library以渲染 erubis 模板：
+需要引入 `erubis` gem/library以填充 erubis 模板：
 
 ~~~~ ruby
 # 你需要在你的应用中引入 erubis
@@ -325,11 +333,11 @@ get '/' do
 end
 ~~~~
 
-使用Erubis来渲染 `./views/index.erb`。
+使用Erubis来填充 `./views/index.erb`。
 
 ### Builder 模板
 
-需要引入 `builder` gem/library 以渲染 builder templates：
+需要引入 `builder` gem/library 以填充 builder templates：
 
 ~~~~ ruby
 # 需要在你的应用中引入builder
@@ -344,7 +352,7 @@ end
 
 ### Nokogiri 模板
 
-需要引入 `nokogiri` gem/library 以渲染 nokogiri 模板：
+需要引入 `nokogiri` gem/library 以填充 nokogiri 模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入 nokogiri
@@ -359,7 +367,7 @@ end
 
 ### Sass 模板
 
-需要引入 `haml` 或者 `sass` gem/library 以渲染 Sass 模板：
+需要引入 `haml` 或者 `sass` gem/library 以填充 Sass 模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入 haml 或者 sass
@@ -388,7 +396,7 @@ end
 
 ### Scss 模板
 
-需要引入 `haml` 或者 `sass` gem/library 来渲染 Scss templates：
+需要引入 `haml` 或者 `sass` gem/library 来填充 Scss templates：
 
 ~~~~ ruby
 # 需要在你的应用中引入 haml 或者 sass
@@ -416,7 +424,7 @@ end
 
 ### Less 模板
 
-需要引入 `less` gem/library 以渲染 Less 模板：
+需要引入 `less` gem/library 以填充 Less 模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入 less
@@ -431,7 +439,7 @@ end
 
 ### Liquid 模板
 
-需要引入 `liquid` gem/library 来渲染 Liquid 模板：
+需要引入 `liquid` gem/library 来填充 Liquid 模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入 liquid
@@ -453,7 +461,7 @@ liquid :index, :locals => { :key => 'value' }
 
 ### Markdown 模板
 
-需要引入 `rdiscount` gem/library 以渲染 Markdown 模板：
+需要引入 `rdiscount` gem/library 以填充 Markdown 模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入rdiscount
@@ -467,7 +475,7 @@ end
 这里调用的是 `./views/index.markdown` (`md` 和 `mkd` 也是合理的文件扩展名)。
 
 在markdown中是不可以调用方法的，也不可以传递 locals给它。
-你因此一般会结合其他的渲染引擎来使用它：
+你因此一般会结合其他的填充引擎来使用它：
 
 ~~~~ ruby
 erb :overview, :locals => { :text => markdown(:introduction) }
@@ -481,7 +489,7 @@ erb :overview, :locals => { :text => markdown(:introduction) }
 ~~~~
 
 既然你不能在Markdown中调用Ruby，你不能使用Markdown编写的布局。
-不过，使用其他渲染引擎作为模版的布局是可能的，
+不过，使用其他填充引擎作为模版的布局是可能的，
 通过传递`:layout_engine`选项:
 
 ~~~~ ruby
@@ -519,11 +527,11 @@ get '/' do
 end
 ~~~~
 
-使用BlueCloth来渲染 `./views/index.md` 。
+使用BlueCloth来填充 `./views/index.md` 。
 
 ### Textile 模板
 
-需要引入 `RedCloth` gem/library 以渲染 Textile 模板：
+需要引入 `RedCloth` gem/library 以填充 Textile 模板：
 
 ~~~~ ruby
 # 在你的应用中引入redcloth
@@ -537,7 +545,7 @@ end
 这里调用的是 `./views/index.textile`。
 
 在textile中是不可以调用方法的，也不可以传递 locals给它。
-你因此一般会结合其他的渲染引擎来使用它：
+你因此一般会结合其他的填充引擎来使用它：
 
 ~~~~ ruby
 erb :overview, :locals => { :text => textile(:introduction) }
@@ -551,7 +559,7 @@ erb :overview, :locals => { :text => textile(:introduction) }
 ~~~~
 
 既然你不能在Textile中调用Ruby，你不能使用Textile编写的布局。
-不过，使用其他渲染引擎作为模版的布局是可能的，
+不过，使用其他填充引擎作为模版的布局是可能的，
 通过传递`:layout_engine`选项:
 
 ~~~~ ruby
@@ -560,7 +568,7 @@ get '/' do
 end
 ~~~~
 
-这将会渲染 `./views/index.textile` 并使用 `./views/layout.erb`
+这将会填充 `./views/index.textile` 并使用 `./views/layout.erb`
 作为布局。
 
 请记住你可以全局设定这个选项:
@@ -578,7 +586,7 @@ end
 
 ### RDoc 模板
 
-需要引入 `RDoc` gem/library 以渲染RDoc模板：
+需要引入 `RDoc` gem/library 以填充RDoc模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入rdoc/markup/to_html
@@ -593,7 +601,7 @@ end
 这里调用的是 `./views/index.rdoc`。
 
 在rdoc中是不可以调用方法的，也不可以传递locals给它。
-你因此一般会结合其他的渲染引擎来使用它：
+你因此一般会结合其他的填充引擎来使用它：
 
 ~~~~ ruby
 erb :overview, :locals => { :text => rdoc(:introduction) }
@@ -607,7 +615,7 @@ erb :overview, :locals => { :text => rdoc(:introduction) }
 ~~~~
 
 既然你不能在RDoc中调用Ruby，你不能使用RDoc编写的布局。
-不过，使用其他渲染引擎作为模版的布局是可能的，
+不过，使用其他填充引擎作为模版的布局是可能的，
 通过传递`:layout_engine`选项:
 
 ~~~~ ruby
@@ -633,7 +641,7 @@ end
 
 ### Radius 模板
 
-需要引入 `radius` gem/library 以渲染 Radius 模板：
+需要引入 `radius` gem/library 以填充 Radius 模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入radius
@@ -655,7 +663,7 @@ radius :index, :locals => { :key => 'value' }
 
 ### Markaby 模板
 
-需要引入`markaby` gem/library以渲染Markaby模板：
+需要引入`markaby` gem/library以填充Markaby模板：
 
 ~~~~ ruby
 #需要在你的应用中引入 markaby
@@ -678,7 +686,7 @@ end
 
 ### Slim 模板
 
-需要引入 `slim` gem/library 来渲染 Slim 模板：
+需要引入 `slim` gem/library 来填充 Slim 模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入 slim
@@ -693,7 +701,7 @@ end
 
 ### Creole 模板
 
-需要引入 `creole` gem/library 来渲染 Creole 模板：
+需要引入 `creole` gem/library 来填充 Creole 模板：
 
 ~~~~ ruby
 # 需要在你的应用中引入 creole
@@ -751,7 +759,7 @@ end
 
 ~~~~ ruby
 get '/:id' do
-  @foo = Foo.find(params[:id])
+  @foo = Foo.find(params['id'])
   haml '%h1= @foo.name'
 end
 ~~~~
@@ -760,12 +768,12 @@ end
 
 ~~~~ ruby
 get '/:id' do
-  foo = Foo.find(params[:id])
+  foo = Foo.find(params['id'])
   haml '%h1= foo.name', :locals => { :foo => foo }
 end
 ~~~~
 
-典型的使用情况是在别的模板中按照局部模板的方式来渲染。
+典型的使用情况是在别的模板中按照局部模板的方式来填充。
 
 ### 内联模板
 
@@ -810,7 +818,7 @@ get '/' do
 end
 ~~~~
 
-如果存在名为“layout”的模板，该模板会在每个模板渲染的时候被使用。
+如果存在名为“layout”的模板，该模板会在每个模板填充的时候被使用。
 你可以单独地通过传送 `:layout => false`来禁用，
 或者通过`set :haml, :layout => false`来禁用他们。
 
@@ -832,7 +840,7 @@ Tilt.register :tt, Tilt[:textile]
 
 ### 添加你自己的模版引擎
 
-首先，通过Tilt注册你自己的引擎，然后创建一个渲染方法:
+首先，通过Tilt注册你自己的引擎，然后创建一个填充方法:
 
 ~~~~ ruby
 Tilt.register :myat, MyAwesomeTemplateEngine
@@ -863,7 +871,7 @@ end
 
 get '/foo/*' do
   @note #=> 'Hi!'
-  params[:splat] #=> 'bar/baz'
+  params['splat'] #=> 'bar/baz'
 end
 ~~~~
 
@@ -888,7 +896,7 @@ before '/protected/*' do
 end
 
 after '/create/:slug' do |slug|
-  session[:last_slug] = slug
+  session['last_slug'] = slug
 end
 ~~~~
 
@@ -916,7 +924,7 @@ helpers do
 end
 
 get '/:name' do
-  bar(params[:name])
+  bar(params['name'])
 end
 ~~~~
 
@@ -929,11 +937,11 @@ Session被用来在请求之间保持状态。如果被激活，每一个用户
 enable :sessions
 
 get '/' do
-  "value = " << session[:value].inspect
+  "value = " << session['value'].inspect
 end
 
 get '/:value' do
-  session[:value] = params[:value]
+  session['value'] = params['value']
 end
 ~~~~
 
@@ -946,11 +954,11 @@ end
 use Rack::Session::Pool, :expire_after => 2592000
 
 get '/' do
-  "value = " << session[:value].inspect
+  "value = " << session['value'].inspect
 end
 
 get '/:value' do
-  session[:value] = params[:value]
+  session['value'] = params['value']
 end
 ~~~~
 
@@ -992,7 +1000,7 @@ halt 402, {'Content-Type' => 'text/plain'}, 'revenge'
 
 ~~~~ ruby
 get '/guess/:who' do
-  pass unless params[:who] == 'Frank'
+  pass unless params['who'] == 'Frank'
   'You got me!'
 end
 
@@ -1138,12 +1146,12 @@ redirect to('/bar?sum=42')
 enable :sessions
 
 get '/foo' do
-  session[:secret] = 'foo'
+  session['secret'] = 'foo'
   redirect to('/bar')
 end
 
 get '/bar' do
-  session[:secret]
+  session['secret']
 end
 ~~~~
 
@@ -1184,7 +1192,7 @@ end
 
 ~~~~ ruby
 get '/article/:id' do
-  @article = Article.find params[:id]
+  @article = Article.find params['id']
   last_modified @article.updated_at
   etag @article.sha1
   erb :article
@@ -1334,7 +1342,7 @@ end
 
 ### 查找模板文件
 
-`find_template` 辅助方法被用于在渲染时查找模板文件:
+`find_template` 辅助方法被用于在填充时查找模板文件:
 
 ~~~~ ruby
 find_template settings.views, 'foo', Tilt[:haml] do |file|
@@ -1450,7 +1458,7 @@ end
         </p>
     </dd>
 
-    <dt>add_charsets</dt>
+    <dt>add_charset</dt>
     <dd>
         <p>
             设定 <tt>content_type</tt> 辅助方法会 自动加上字符集信息的多媒体类型。
@@ -1458,7 +1466,7 @@ end
 
         <p>
             你应该添加而不是覆盖这个选项:
-            <tt>settings.add_charsets << "application/foobar"</tt>
+            <tt>settings.add_charset << "application/foobar"</tt>
         </p>
     </dd>
 
@@ -1603,7 +1611,7 @@ end
 
 ~~~~ ruby
 error do
-  'Sorry there was a nasty error - ' + env['sinatra.error'].name
+  'Sorry there was a nasty error - ' + env['sinatra.error'].message
 end
 ~~~~
 
@@ -1652,7 +1660,7 @@ end
 
 ## Rack 中间件
 
-Sinatra 依靠 [Rack](http://rack.rubyforge.org/), 一个面向Ruby
+Sinatra 依靠 [Rack](http://rack.github.io/), 一个面向Ruby
 web框架的最小标准接口。
 Rack的一个最有趣的面向应用开发者的能力是支持“中间件”——坐落在服务器和你的应用之间，
 监视 并/或 操作HTTP请求/响应以 提供多样类型的常用功能。
@@ -1672,7 +1680,7 @@ end
 ~~~~
 
 `use` 的语义和在
-[Rack::Builder](http://rack.rubyforge.org/doc/classes/Rack/Builder.html)
+[Rack::Builder](http://rubydoc.info/github/rack/rack/master/Rack/Builder)
 DSL(在rack文件中最频繁使用)中定义的完全一样。例如，`use` 方法接受
 多个/可变 参数，包括代码块：
 
@@ -1693,10 +1701,10 @@ Sinatra的测试可以使用任何基于Rack的测试程序库或者框架来编
 
 ~~~~ ruby
 require 'my_sinatra_app'
-require 'test/unit'
+require 'minitest/autorun'
 require 'rack/test'
 
-class MyAppTest < Test::Unit::TestCase
+class MyAppTest < Minitest::Test
   include Rack::Test::Methods
 
   def app
@@ -1866,8 +1874,8 @@ class LoginScreen < Sinatra::Base
   get('/login') { haml :login }
 
   post('/login') do
-    if params[:name] = 'admin' and params[:password] = 'admin'
-      session['user_name'] = params[:name]
+    if params['name'] = 'admin' and params['password'] = 'admin'
+      session['user_name'] = params['name']
     else
       redirect '/login'
     end
@@ -1935,7 +1943,7 @@ end
 
 对于每个进入的请求，一个新的应用类的实例会被创建
 所有的处理器代码块在该变量域被运行。在这个变量域中， 你可以访问
-\`request\` 和 \`session\` 对象，或者调用渲染方法比如 \`erb\` 或者
+\`request\` 和 \`session\` 对象，或者调用填充方法比如 \`erb\` 或者
 \`haml\`。你可以在请求变量域当中通过\`settings\`辅助方法
 访问应用变量域：
 
@@ -1946,8 +1954,8 @@ class MyApp < Sinatra::Base
     # 针对 '/define_route/:name' 的请求变量域
     @value = 42
 
-    settings.get("/#{params[:name]}") do
-      # 针对 "/#{params[:name]}" 的请求变量域
+    settings.get("/#{params['name']}") do
+      # 针对 "/#{params['name']}" 的请求变量域
       @value # => nil (并不是相同的请求)
     end
 
@@ -2149,10 +2157,10 @@ gem 'activerecord', '~> 3.0'  # 也许你还需要 ActiveRecord 3.x
 -   [IRC: \#sinatra](irc://chat.freenode.net/#sinatra) on
     [freenode.net](http://freenode.net)
 
--   [Sinatra宝典](http://sinatra-book.gittr.com/) Cookbook教程
+-   [Sinatra宝典](https://github.com/sinatra/sinatra-book/) Cookbook教程
 
 -   [Sinatra使用技巧](http://recipes.sinatrarb.com/) 网友贡献的实用技巧
-   
+
 -   [最新版本](http://rubydoc.info/gems/sinatra)API文档；[http://rubydoc.info](http://rubydoc.info)的[当前HEAD](http://rubydoc.info/github/sinatra/sinatra)
 
 -   [CI服务器](http://travis-ci.org/sinatra/sinatra)