sinatra 1.4.4 → 1.4.5

data/README.zh.md

@@ -1,10 +1,10 @@
 # Sinatra
 
-*注：本文档仅仅是英文版的翻译，会出现内容没有及时更新的情况发生。
+*注：本文档是英文版的翻译，内容更新有可能不及时。
 如有不一致的地方，请以英文版为准。*
 
-Sinatra是一个基于Ruby语言，以最小精力为代价快速创建web应用为目的的[DSL](http://en.wikipedia.org/wiki/Domain-specific_language)（
-领域专属语言）：
+Sinatra是一个基于Ruby语言的[DSL](http://en.wikipedia.org/wiki/Domain-specific_language)（
+领域专属语言），可以轻松、快速的创建web应用。
 
 ~~~~ ruby
 # myapp.rb
@@ -15,7 +15,7 @@ get '/' do
 end
 ~~~~
 
-安装gem然后运行：
+安装gem，然后运行：
 
 ~~~~ shell
 gem install sinatra
@@ -24,33 +24,43 @@ ruby myapp.rb
 
 在该地址查看： [localhost:4567](http://localhost:4567)
 
-推荐同时运行`gem install thin`，Sinatra会优先选择thin作为服务器。
+安装Sintra后，最好再运行`gem install thin`安装Thin。这样，Sinatra会优先选择Thin作为服务器。
 
-## 路由
+## 路由(route)
 
-在Sinatra中，一个路由是一个HTTP方法与URL匹配范式的配对。
-每个路由都与一个代码块关联：
+在Sinatra中，一个路由分为两部分：HTTP方法(GET, POST等)和URL匹配范式。
+每个路由都有一个要执行的代码块：
 
 ~~~~ ruby
 get '/' do
-  .. 显示一些事物 ..
+  .. 显示内容 ..
 end
 
 post '/' do
-  .. 创建一些事物 ..
+  .. 创建内容 ..
 end
 
 put '/' do
-  .. 更新一些事物 ..
+  .. 更新内容 ..
 end
 
 delete '/' do
-  .. 消灭一些事物 ..
+  .. 删除内容 ..
 end
 
 options '/' do
-  .. 满足一些事物 ..
+  .. 显示命令列表 ..
 end
+
+link '/' do
+  .. 建立某种联系 ..
+end
+
+unlink '/' do
+  .. 解除某种联系 ..
+end
+
+
 ~~~~
 
 路由按照它们被定义的顺序进行匹配。 第一个与请求匹配的路由会被调用。
@@ -133,7 +143,7 @@ get '/', :provides => ['rss', 'atom', 'xml'] do
 end
 ~~~~
 
-你也可以很轻松地定义自己的条件：
+你也可以自定义条件：
 
 ~~~~ ruby
 set(:probability) { |value| condition { rand <= value } }
@@ -206,7 +216,7 @@ get all_but("/index") do
 end
 ~~~~
 
-请注意上面的例子可能超工程了， 因为它也可以用更简单的方式表述:
+上面的例子可能太繁琐了， 因为它也可以用更简单的方式表述:
 
 ~~~~ ruby
 get // do
@@ -287,7 +297,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.erb`
+这里调用的是 `./views/index.erb`
 
 ### Erubis
 
@@ -302,7 +312,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.erubis`
+这里调用的是 `./views/index.erubis`
 
 使用Erubis代替Erb也是可能的:
 
@@ -330,7 +340,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.builder`。
+这里调用的是 `./views/index.builder`。
 
 ### Nokogiri 模板
 
@@ -345,7 +355,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.nokogiri`。
+这里调用的是 `./views/index.nokogiri`。
 
 ### Sass 模板
 
@@ -360,7 +370,7 @@ get '/stylesheet.css' do
 end
 ~~~~
 
-渲染 `./views/stylesheet.sass`。
+这里调用的是 `./views/stylesheet.sass`。
 
 [Sass
 的选项](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options)
@@ -389,7 +399,7 @@ get '/stylesheet.css' do
 end
 ~~~~
 
-渲染 `./views/stylesheet.scss`。
+这里调用的是 `./views/stylesheet.scss`。
 
 [Scss的选项](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options)
 可以通过Sinatra选项全局设定， 参考
@@ -417,7 +427,7 @@ get '/stylesheet.css' do
 end
 ~~~~
 
-渲染 `./views/stylesheet.less`。
+这里调用的是 `./views/stylesheet.less`。
 
 ### Liquid 模板
 
@@ -432,7 +442,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.liquid`。
+这里调用的是 `./views/index.liquid`。
 
 因为你不能在Liquid 模板中调用 Ruby 方法 (除了 `yield`) ，
 你几乎总是需要传递locals给它：
@@ -454,7 +464,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.markdown` (`md` 和 `mkd` 也是合理的文件扩展名)。
+这里调用的是 `./views/index.markdown` (`md` 和 `mkd` 也是合理的文件扩展名)。
 
 在markdown中是不可以调用方法的，也不可以传递 locals给它。
 你因此一般会结合其他的渲染引擎来使用它：
@@ -480,7 +490,7 @@ get '/' do
 end
 ~~~~
 
-这将会渲染 `./views/index.md` 并使用 `./views/layout.erb` 作为布局。
+这将会调用 `./views/index.md` 并使用 `./views/layout.erb` 作为布局。
 
 请记住你可以全局设定这个选项:
 
@@ -492,7 +502,7 @@ get '/' do
 end
 ~~~~
 
-这将会渲染 `./views/index.markdown` (和任何其他的 Markdown 模版) 并使用
+这将会调用 `./views/index.markdown` (和任何其他的 Markdown 模版) 并使用
 `./views/post.haml` 作为布局.
 
 也可能使用BlueCloth而不是RDiscount来解析Markdown文件:
@@ -524,7 +534,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.textile`。
+这里调用的是 `./views/index.textile`。
 
 在textile中是不可以调用方法的，也不可以传递 locals给它。
 你因此一般会结合其他的渲染引擎来使用它：
@@ -563,7 +573,7 @@ get '/' do
 end
 ~~~~
 
-这将会渲染 `./views/index.textile` (和任何其他的 Textile 模版) 并使用
+这将会调用 `./views/index.textile` (和任何其他的 Textile 模版) 并使用
 `./views/post.haml` 作为布局.
 
 ### RDoc 模板
@@ -580,7 +590,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.rdoc`。
+这里调用的是 `./views/index.rdoc`。
 
 在rdoc中是不可以调用方法的，也不可以传递locals给它。
 你因此一般会结合其他的渲染引擎来使用它：
@@ -606,7 +616,7 @@ get '/' do
 end
 ~~~~
 
-这将会渲染 `./views/index.rdoc` 并使用 `./views/layout.erb` 作为布局。
+这将会调用 `./views/index.rdoc` 并使用 `./views/layout.erb` 作为布局。
 
 请记住你可以全局设定这个选项:
 
@@ -618,7 +628,7 @@ get '/' do
 end
 ~~~~
 
-这将会渲染 `./views/index.rdoc` (和任何其他的 RDoc 模版) 并使用
+这将会调用 `./views/index.rdoc` (和任何其他的 RDoc 模版) 并使用
 `./views/post.haml` 作为布局.
 
 ### Radius 模板
@@ -634,7 +644,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.radius`。
+这里调用的是 `./views/index.radius`。
 
 因为你不能在Radius 模板中调用 Ruby 方法 (除了 `yield`) ，
 你几乎总是需要传递locals给它：
@@ -656,7 +666,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.mab`。
+这里调用的是 `./views/index.mab`。
 
 你也可以使用嵌入的 Markaby:
 
@@ -679,7 +689,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.slim`。
+这里调用的是 `./views/index.slim`。
 
 ### Creole 模板
 
@@ -694,7 +704,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.creole`。
+这里调用的是 `./views/index.creole`。
 
 ### CoffeeScript 模板
 
@@ -711,7 +721,7 @@ end
 [github.com/josh/ruby-coffee-script](http://github.com/josh/ruby-coffee-script)
 获取更新的选项。
 
-现在你可以渲染 CoffeeScript 模版了:
+现在你可以调用 CoffeeScript 模版了:
 
 ~~~~ ruby
 # 需要在你的应用中引入coffee-script
@@ -722,7 +732,7 @@ get '/application.js' do
 end
 ~~~~
 
-渲染 `./views/application.coffee`。
+这里调用的是 `./views/application.coffee`。
 
 ### 嵌入模板字符串
 
@@ -732,7 +742,7 @@ get '/' do
 end
 ~~~~
 
-渲染嵌入模板字符串。
+调用嵌入模板字符串。
 
 ### 在模板中访问变量
 
@@ -836,7 +846,7 @@ get '/' do
 end
 ~~~~
 
-渲染 `./views/index.myat`。察看
+这里调用的是 `./views/index.myat`。察看
 [github.com/rtomayko/tilt](https://github.com/rtomayko/tilt)
 来更多了解Tilt.
 
@@ -1019,7 +1029,7 @@ end
 如果你希望请求被发送到同一个应用，而不是副本， 使用 `call!` 而不是
 `call`.
 
-察看 Rack specification 如果你想更多了解 `call`.
+如果想更多了解 `call`，请察看 Rack specification。
 
 ### 设定 消息体，状态码和消息头
 
@@ -1056,16 +1066,16 @@ end
 如同 `body`, 不带参数的 `headers` 和 `status` 可以用来访问
 他们你的当前值.
 
-### 媒体类型
+### 媒体(MIME)类型
 
-当使用 `send_file` 或者静态文件的场合，你的媒体类型可能
-Sinatra并不理解。使用 `mime_type` 通过文件扩展名来注册它们：
+使用 `send_file` 或者静态文件的时候，Sinatra可能不能识别你的媒体类型。
+使用 `mime_type` 通过文件扩展名来注册它们：
 
 ~~~~ ruby
 mime_type :foo, 'text/foo'
 ~~~~
 
-你也可以通过 `content_type` 辅助方法使用：
+你也可以使用 `content_type` 辅助方法：
 
 ~~~~ ruby
 get '/' do
@@ -1082,7 +1092,7 @@ end
 %a{:href => url('/foo')} foo
 ~~~~
 
-它会根据反向代理和Rack路由，如果有的话，来计算生成的URL。
+如果使用反向代理和Rack路由，生成URL的时候会考虑这些因素。
 
 这个方法还有一个别名 `to` (见下面的例子).
 
@@ -1096,14 +1106,14 @@ get '/foo' do
 end
 ~~~~
 
-任何额外的参数都会被以 `halt`相同的方式来处理:
+其他参数的用法，与 `halt`相同:
 
 ~~~~ ruby
 redirect to('/bar'), 303
 redirect 'http://google.com', 'wrong place, buddy'
 ~~~~
 
-你可以方便的通过 `redirect back`把用户重定向到来自的页面:
+用 `redirect back`可以把用户重定向到原始页面:
 
 ~~~~ ruby
 get '/foo' do
@@ -1116,13 +1126,13 @@ get '/bar' do
 end
 ~~~~
 
-为了传递参数给redirect，或者加入query:
+如果想传递参数给redirect，可以用query string:
 
 ~~~~ ruby
 redirect to('/bar?sum=42')
 ~~~~
 
-或者使用session:
+或者用session:
 
 ~~~~ ruby
 enable :sessions
@@ -1139,9 +1149,9 @@ end
 
 ### 缓存控制
 
-正确地设定消息头是恰当的HTTP缓存的基础。
+要使用HTTP缓存，必须正确地设定消息头。
 
-你可以方便的设定 Cache-Control 消息头，像这样:
+你可以这样设定 Cache-Control 消息头:
 
 ~~~~ ruby
 get '/' do
@@ -1167,9 +1177,10 @@ before do
 end
 ~~~~
 
-为了合适地使用缓存，你应该考虑使用 `etag` 和 `last_modified`方法。.
-推荐在执行繁重任务\*之前\*使用这些helpers，
-他们会立刻发送响应，如果客户端在缓存中已经有了当前版本。
+为了合适地使用缓存，你应该考虑使用 `etag` 和 `last_modified`方法。
+推荐在执行繁重任务\*之前\*使用这些helpers，这样一来，
+如果客户端在缓存中已经有相关内容，就会立即得到显示。
+
 
 ~~~~ ruby
 get '/article/:id' do
@@ -1243,7 +1254,7 @@ send_file 'foo.png', :type => :jpg
     <dd>Content-Length 的值，默认是文件的大小。</dd>
 </dl>
 
-如果Rack处理器支持，Ruby进程除streaming以外的方式会被使用。
+如果Rack处理器支持的话，Ruby进程也能使用除streaming以外的方法。
 如果你使用这个辅助方法， Sinatra会自动处理range请求。
 
 ### 访问请求对象
@@ -2137,3 +2148,11 @@ 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使用技巧](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)

data/Rakefile

@@ -111,7 +111,7 @@ end
 desc "list of authors"
 task :authors, [:commit_range, :format, :sep] do |t, a|
   a.with_defaults :format => "%s (%d)", :sep => ", ", :commit_range => '--all'
-  authors = Hash.new { |h,k| h[k] = 0 }
+  authors = Hash.new(0)
   blake   = "Blake Mizerany"
   overall = 0
   mapping = {

data/lib/sinatra/base.rb

@@ -32,7 +32,7 @@ module Sinatra
     end
 
     def accept?(type)
-      preferred_type(type).include?(type)
+      preferred_type(type).to_s.include?(type)
     end
 
     def preferred_type(*types)
@@ -658,6 +658,7 @@ module Sinatra
     def initialize
       super
       @default_layout = :layout
+      @preferred_extension = nil
     end
 
     def erb(template, options = {}, locals = {}, &block)
@@ -715,6 +716,10 @@ module Sinatra
       render :rdoc, template, options, locals
     end
 
+    def asciidoc(template, options = {}, locals = {})
+      render :asciidoc, template, options, locals
+    end
+
     def radius(template, options = {}, locals = {})
       render :radius, template, options, locals
     end
@@ -741,6 +746,10 @@ module Sinatra
       render :creole, template, options, locals
     end
 
+    def mediawiki(template, options = {}, locals = {})
+      render :mediawiki, template, options, locals
+    end
+
     def wlang(template, options = {}, locals = {}, &block)
       render(:wlang, template, options, locals, &block)
     end
@@ -809,7 +818,7 @@ module Sinatra
 
       # render layout
       if layout
-        options.merge!(:views => views, :layout => false, :eat_errors => eat_errors, :scope => scope).
+        options = options.merge(:views => views, :layout => false, :eat_errors => eat_errors, :scope => scope).
                 merge!(layout_options)
         catch(:layout_missing) { return render(layout_engine, layout, options, locals) { output } }
       end
@@ -835,7 +844,7 @@ module Sinatra
             @preferred_extension = engine.to_s
             find_template(views, data, template) do |file|
               path ||= file # keep the initial path rather than the last one
-              if found = File.exists?(file)
+              if found = File.exist?(file)
                 path = file
                 break
               end
@@ -1015,14 +1024,14 @@ module Sinatra
 
     # Attempt to serve static files from public directory. Throws :halt when
     # a matching file is found, returns nil otherwise.
-    def static!
+    def static!(options = {})
       return if (public_dir = settings.public_folder).nil?
       path = File.expand_path("#{public_dir}#{unescape(request.path_info)}" )
       return unless File.file?(path)
 
       env['sinatra.static_file'] = path
       cache_control(*settings.static_cache_control) if settings.static_cache_control?
-      send_file path, :disposition => nil
+      send_file path, options.merge(:disposition => nil)
     end
 
     # Enable string or symbol key access to the nested params hash.
@@ -1129,7 +1138,7 @@ module Sinatra
 
     class << self
       CALLERS_TO_IGNORE = [ # :nodoc:
-        /\/sinatra(\/(base|main|showexceptions))?\.rb$/,    # all sinatra code
+        /\/sinatra(\/(base|main|show_exceptions))?\.rb$/,    # all sinatra code
         /lib\/tilt.*\.rb$/,                                 # all tilt code
         /^\(.*\)$/,                                         # generated code
         /rubygems\/(custom|core_ext\/kernel)_require\.rb$/, # rubygems require hacks
@@ -1575,6 +1584,7 @@ module Sinatra
       end
 
       def generate_method(method_name, &block)
+        method_name = method_name.to_sym
         define_method(method_name, &block)
         method = instance_method method_name
         remove_method method_name
@@ -1828,7 +1838,7 @@ module Sinatra
     set :use_code, false
     set :default_encoding, "utf-8"
     set :x_cascade, true
-    set :add_charset, %w[javascript xml xhtml+xml json].map { |t| "application/#{t}" }
+    set :add_charset, %w[javascript xml xhtml+xml].map { |t| "application/#{t}" }
     settings.add_charset << /^text\//
 
     # explicitly generating a session secret eagerly to play nice with preforking