sinatra 1.4.6 → 2.0.0

data/README.ja.md

@@ -1,11 +1,11 @@
 # Sinatra
 
 *注）
-本文書は英語から翻訳したものであり、その内容が最新でない場合もあります。最新の情報はオリジナルの英語版を参照して下さい。*
+本文書は英語から翻訳したものであり、その内容が最新でない場合もあります。最新の情報はオリジナルの英語版を参照してください。*
 
-Sinatraは最小の労力でRubyによるWebアプリケーションを手早く作るための[DSL](http://ja.wikipedia.org/wiki/ドメイン固有言語)です。
+Sinatraは最小の労力でRubyによるWebアプリケーションを手早く作るための[DSL](https://ja.wikipedia.org/wiki/メインページドメイン固有言語)です。
 
-``` ruby
+```ruby
 # myapp.rb
 require 'sinatra'
 
@@ -16,17 +16,17 @@ end
 
 gemをインストールし、
 
-``` shell
+```shell
 gem install sinatra
 ```
 
 次のように実行します。
 
-``` shell
+```shell
 ruby myapp.rb
 ```
 
-[localhost:4567](http://localhost:4567) を開きます。
+[http://localhost:4567](http://localhost:4567) を開きます。
 
 ThinがあればSinatraはこれを利用するので、`gem install thin`することをお薦めします。
 
@@ -70,9 +70,11 @@ ThinがあればSinatraはこれを利用するので、`gem install thin`する
         * [名前付きテンプレート(Named Templates)](#名前付きテンプレートnamed-templates)
         * [ファイル拡張子の関連付け](#ファイル拡張子の関連付け)
         * [オリジナルテンプレートエンジンの追加](#オリジナルテンプレートエンジンの追加)
+        * [カスタムロジックを使用したテンプレートの探索](#カスタムロジックを使用したテンプレートの探索)
     * [フィルタ(Filters)](#フィルタfilters)
     * [ヘルパー(Helpers)](#ヘルパーhelpers)
         * [セッションの使用](#セッションの使用)
+        * [セッションミドルウェアの選択](#セッションミドルウェアの選択)
         * [停止(Halting)](#停止halting)
         * [パッシング(Passing)](#パッシングpassing)
         * [別ルーティングの誘発](#別ルーティングの誘発)
@@ -109,6 +111,7 @@ ThinがあればSinatraはこれを利用するので、`gem install thin`する
         * [リクエスト/インスタンスのスコープ](#リクエストインスタンスのスコープ)
         * [デリゲートスコープ](#デリゲートスコープ)
     * [コマンドライン](#コマンドライン)
+        * [マルチスレッド](#マルチスレッド)
     * [必要環境](#必要環境)
     * [最新開発版](#最新開発版)
         * [Bundlerを使う場合](#bundlerを使う場合)
@@ -122,7 +125,7 @@ ThinがあればSinatraはこれを利用するので、`gem install thin`する
 Sinatraでは、ルーティングはHTTPメソッドとURLマッチングパターンがペアになっています。
 ルーティングはブロックに結び付けられています。
 
-``` ruby
+```ruby
 get '/' do
   .. 何か見せる ..
 end
@@ -159,10 +162,18 @@ end
 ルーティングは定義された順番にマッチします。
 リクエストに最初にマッチしたルーティングが呼び出されます。
 
+トレイリングスラッシュを付けたルートは、そうでないルートと異なったものになります。
+
+```ruby
+    get '/foo' do
+      # Does not match "GET /foo/"
+    end
+```
+
 ルーティングのパターンは名前付きパラメータを含むことができ、
 `params`ハッシュで取得できます。
 
-``` ruby
+```ruby
 get '/hello/:name' do
   # "GET /hello/foo" と "GET /hello/bar" にマッチ
   # params['name'] は 'foo' か 'bar'
@@ -172,7 +183,7 @@ end
 
 また、ブロックパラメータで名前付きパラメータにアクセスすることもできます。
 
-``` ruby
+```ruby
 get '/hello/:name' do |n|
   # "GET /hello/foo" と "GET /hello/bar" にマッチ
   # params['name'] は 'foo' か 'bar'
@@ -184,7 +195,7 @@ end
 ルーティングパターンはアスタリスク(すなわちワイルドカード)を含むこともでき、
 `params['splat']` で取得できます。
 
-``` ruby
+```ruby
 get '/say/*/to/*' do
   # /say/hello/to/world にマッチ
   params['splat'] # => ["hello", "world"]
@@ -198,7 +209,7 @@ end
 
 ここで、ブロックパラメータを使うこともできます。
 
-``` ruby
+```ruby
 get '/download/*.*' do |path, ext|
   [path, ext] # => ["path/to/file", "xml"]
 end
@@ -206,15 +217,15 @@ end
 
 ルーティングを正規表現にマッチさせることもできます。
 
-``` ruby
-get /\A\/hello\/([\w]+)\z/ do
+```ruby
+get /\/hello\/([\w]+)/ do
   "Hello, #{params['captures'].first}!"
 end
 ```
 
 ここでも、ブロックパラメータが使えます。
 
-``` ruby
+```ruby
 get %r{/hello/([\w]+)} do |c|
   "Hello, #{c}!"
 end
@@ -222,9 +233,9 @@ end
 
 ルーティングパターンは、オプショナルパラメータを取ることもできます。
 
-``` ruby
-get '/posts.?:format?' do
-  # "GET /posts" と "GET /posts.json", "GET /posts.xml" の拡張子などにマッチ
+```ruby
+get '/posts/:format?' do
+  # "GET /posts/" と "GET /posts/json", "GET /posts/xml" の拡張子などにマッチ
 end
 ```
 
@@ -235,7 +246,7 @@ end
 
 ルーティングにはユーザエージェントのようなさまざまな条件を含めることができます。
 
-``` ruby
+```ruby
 get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
   "Songbirdのバージョン #{params['agent'][0]}を使ってます。"
 end
@@ -247,7 +258,7 @@ end
 
 ほかに`host_name`と`provides`条件が利用可能です。
 
-``` ruby
+```ruby
 get '/', :host_name => /^admin\./ do
   "Adminエリアです。アクセスを拒否します!"
 end
@@ -263,7 +274,7 @@ end
 
 独自の条件を定義することも簡単にできます。
 
-``` ruby
+```ruby
 set(:probability) { |value| condition { rand <= value } }
 
 get '/win_a_car', :probability => 0.1 do
@@ -277,7 +288,7 @@ end
 
 複数の値を取る条件には、アスタリスクを使います。
 
-``` ruby
+```ruby
 set(:auth) do |*roles|   # <- ここでアスタリスクを使う
   condition do
     unless logged_in? && roles.any? {|role| current_user.in_role? role }
@@ -313,7 +324,7 @@ Rackレスポンス、Rackボディオブジェクト、HTTPステータスコ
 
 これにより、例えばストリーミングを簡単に実装することができます。
 
-``` ruby
+```ruby
 class Stream
   def each
     100.times { |i| yield "#{i}\n" }
@@ -329,7 +340,7 @@ get('/') { Stream.new }
 
 先述のようにSinatraはルーティングマッチャーとして、文字列パターンと正規表現を使うことをビルトインでサポートしています。しかしこれに留まらず、独自のマッチャーを簡単に定義することもできるのです。
 
-``` ruby
+```ruby
 class AllButPattern
   Match = Struct.new(:captures)
 
@@ -354,7 +365,7 @@ end
 
 ノート: この例はオーバースペックであり、以下のようにも書くことができます。
 
-``` ruby
+```ruby
 get // do
   pass if request.path_info == "/index"
   # ...
@@ -363,19 +374,18 @@ end
 
 または、否定先読みを使って:
 
-``` ruby
-get %r{^(?!/index$)} do
+```ruby
+get %r{(?!/index)} do
   # ...
 end
 ```
 
-
 ## 静的ファイル(Static Files)
 
 静的ファイルは`./public`ディレクトリから配信されます。
 `:public_folder`オプションを指定することで別の場所を指定することができます。
 
-``` ruby
+```ruby
 set :public_folder, File.dirname(__FILE__) + '/static'
 ```
 
@@ -388,7 +398,7 @@ set :public_folder, File.dirname(__FILE__) + '/static'
 
 各テンプレート言語はそれ自身のレンダリングメソッドを通して展開されます。それらのメソッドは単に文字列を返します。
 
-``` ruby
+```ruby
 get '/' do
   erb :index
 end
@@ -398,7 +408,7 @@ end
 
 テンプレート名を渡す代わりに、直接そのテンプレートの中身を渡すこともできます。
 
-``` ruby
+```ruby
 get '/' do
   code = "<%= Time.now %>"
   erb code
@@ -407,7 +417,7 @@ end
 
 テンプレートのレイアウトは第２引数のハッシュ形式のオプションをもとに表示されます。
 
-``` ruby
+```ruby
 get '/' do
   erb :index, :layout => :post
 end
@@ -417,8 +427,7 @@ end
 
 Sinatraが理解できないオプションは、テンプレートエンジンに渡されることになります。
 
-
-``` ruby
+```ruby
 get '/' do
   haml :index, :format => :html5
 end
@@ -426,7 +435,7 @@ end
 
 テンプレート言語ごとにオプションをセットすることもできます。
 
-``` ruby
+```ruby
 set :haml, :format => :html5
 
 get '/' do
@@ -447,7 +456,7 @@ end
 
   <dt>default_encoding</dt>
   <dd>
-    文字エンコーディング（不確かな場合に使用される）。デフォルトは、<tt>settings.default_encoding</tt>。
+    文字エンコーディングが確実でない場合に指定。デフォルトは、<tt>settings.default_encoding</tt>。
   </dd>
 
   <dt>views</dt>
@@ -485,30 +494,36 @@ end
 テンプレートは`./views`ディレクトリ下に配置されています。
 他のディレクトリを使用する場合の例:
 
-``` ruby
+```ruby
 set :views, settings.root + '/templates'
 ```
 
-テンプレートはシンボルを使用して参照させることを覚えておいて下さい。
-サブディレクトリでもこの場合は`:'subdir/template'`のようにします。
-レンダリングメソッドは文字列が渡されると、それをそのまま文字列として出力するので、シンボルを使ってください。
+テンプレートの参照は、テンプレートがサブディレクトリ内にある場合でも常にシンボルで指定することを覚えておいてください。
+（これは`:'subdir/template'`または`'subdir/template'.to_sym`のように指定することを意味します。）
+レンダリングメソッドにシンボルではなく文字列を渡してしまうと、そのまま文字列として出力してしまいます。
 
 ### リテラルテンプレート(Literal Templates)
 
-``` ruby
+```ruby
 get '/' do
   haml '%div.title Hello World'
 end
 ```
 
-これはそのテンプレート文字列をレンダリングします。
+これはテンプレート文字列をレンダリングしています。
+テンプレート文字列に関連するファイルパスや行数を`:path`や`:line`オプションで指定することで、バックトレースを明確にすることができます。
+
+```ruby
+get '/' do
+  haml '%div.title Hello World', :path => 'examples/file.haml', :line => 3
+end
+```
 
 ### 利用可能なテンプレート言語
 
 いくつかの言語には複数の実装があります。使用する（そしてスレッドセーフにする）実装を指定するには、それを最初にrequireしてください。
 
-
-``` ruby
+```ruby
 require 'rdiscount' # または require 'bluecloth'
 get('/') { markdown :index }
 ```
@@ -530,7 +545,6 @@ get('/') { markdown :index }
   </tr>
 </table>
 
-
 #### Erb テンプレート
 
 <table>
@@ -577,7 +591,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>依存</td>
-    <td><a href="http://nokogiri.org/" title="nokogiri">nokogiri</a></td>
+    <td><a href="http://www.nokogiri.org/" title="nokogiri">nokogiri</a></td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
@@ -591,7 +605,6 @@ get('/') { markdown :index }
 
 インラインテンプレート用にブロックを取ることもできます（例を参照）。
 
-
 #### Sass テンプレート
 
 <table>
@@ -609,7 +622,6 @@ get('/') { markdown :index }
   </tr>
 </table>
 
-
 #### Scss テンプレート
 
 <table>
@@ -632,7 +644,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>依存</td>
-    <td><a href="http://www.lesscss.org/" title="less">less</a></td>
+    <td><a href="http://lesscss.org/" title="less">less</a></td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
@@ -649,7 +661,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>依存</td>
-    <td><a href="http://www.liquidmarkup.org/" title="liquid">liquid</a></td>
+    <td><a href="http://liquidmarkup.org/" title="liquid">liquid</a></td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
@@ -670,7 +682,7 @@ LiquidテンプレートからRubyのメソッド(`yield`を除く)を呼び出
     <td>依存</td>
     <td>
       次の何れか:
-        <a href="https://github.com/rtomayko/rdiscount" title="RDiscount">RDiscount</a>,
+        <a href="https://github.com/davidfstr/rdiscount" title="RDiscount">RDiscount</a>,
         <a href="https://github.com/vmg/redcarpet" title="RedCarpet">RedCarpet</a>,
         <a href="http://deveiate.org/projects/BlueCloth" title="BlueCloth">BlueCloth</a>,
         <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
@@ -690,20 +702,19 @@ LiquidテンプレートからRubyのメソッド(`yield`を除く)を呼び出
 Markdownからメソッドを呼び出すことも、localsに変数を渡すこともできません。
 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です。
 
-``` ruby
+```ruby
 erb :overview, :locals => { :text => markdown(:introduction) }
 ```
 
 ノート: 他のテンプレート内で`markdown`メソッドを呼び出せます。
 
-``` ruby
+```ruby
 %h1 Hello From Haml!
 %p= markdown(:greetings)
 ```
 
 MarkdownからはRubyを呼ぶことができないので、Markdownで書かれたレイアウトを使うことはできません。しかしながら、`:layout_engine`オプションを渡すことでテンプレートのものとは異なるレンダリングエンジンをレイアウトのために使うことができます。
 
-
 #### Textile テンプレート
 
 <table>
@@ -724,13 +735,13 @@ MarkdownからはRubyを呼ぶことができないので、Markdownで書かれ
 Textileからメソッドを呼び出すことも、localsに変数を渡すこともできません。
 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です。
 
-``` ruby
+```ruby
 erb :overview, :locals => { :text => textile(:introduction) }
 ```
 
 ノート: 他のテンプレート内で`textile`メソッドを呼び出せます。
 
-``` ruby
+```ruby
 %h1 Hello From Haml!
 %p= textile(:greetings)
 ```
@@ -757,14 +768,13 @@ TexttileからはRubyを呼ぶことができないので、Textileで書かれ
 RDocからメソッドを呼び出すことも、localsに変数を渡すこともできません。
 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です。
 
-``` ruby
+```ruby
 erb :overview, :locals => { :text => rdoc(:introduction) }
 ```
 
 ノート: 他のテンプレート内で`rdoc`メソッドを呼び出せます。
 
-
-``` ruby
+```ruby
 %h1 Hello From Haml!
 %p= rdoc(:greetings)
 ```
@@ -809,13 +819,12 @@ AsciiDocテンプレートからRubyのメソッドを直接呼び出すこと
 
 RadiusテンプレートからRubyのメソッドを直接呼び出すことができないため、ほぼ全ての場合にlocalsを指定する必要があるでしょう。
 
-
 #### Markaby テンプレート
 
 <table>
   <tr>
     <td>依存</td>
-    <td><a href="http://markaby.github.com/" title="Markaby">Markaby</a></td>
+    <td><a href="http://markaby.github.io/" title="Markaby">Markaby</a></td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
@@ -883,13 +892,13 @@ RadiusテンプレートからRubyのメソッドを直接呼び出すことが
 Creoleからメソッドを呼び出すことも、localsに変数を渡すこともできません。
 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です。
 
-``` ruby
+```ruby
 erb :overview, :locals => { :text => creole(:introduction) }
 ```
 
 ノート: 他のテンプレート内で`creole`メソッドを呼び出せます。
 
-``` ruby
+```ruby
 %h1 Hello From Haml!
 %p= creole(:greetings)
 ```
@@ -951,7 +960,7 @@ erb :overview, :locals => { :text => mediawiki(:introduction) }
   <tr>
     <td>依存</td>
     <td>
-      <a href="https://github.com/lucasmazza/ruby-stylus" title="Ruby Stylus">
+      <a href="https://github.com/forgecrafted/ruby-stylus" title="Ruby Stylus">
         Stylus
       </a> および
       <a href="https://github.com/sstephenson/execjs/blob/master/README.md#readme" title="ExecJS">
@@ -971,7 +980,7 @@ erb :overview, :locals => { :text => mediawiki(:introduction) }
 
 Stylusテンプレートを使えるようにする前に、まず`stylus`と`stylus/tilt`を読み込む必要があります。
 
-``` ruby
+```ruby
 require 'sinatra'
 require 'stylus'
 require 'stylus/tilt'
@@ -1005,17 +1014,16 @@ end
   </tr>
 </table>
 
-
 テンプレートのソースはRubyの文字列として評価され、その結果のJSON変数は`#to_json`を使って変換されます。
 
-``` ruby
+```ruby
 json = { :foo => 'bar' }
 json[:baz] = key
 ```
 
 `:callback`および`:variable`オプションは、レンダリングされたオブジェクトを装飾するために使うことができます。
 
-``` ruby
+```ruby
 var resource = {"foo":"bar","baz":"qux"}; present(resource);
 ```
 
@@ -1042,7 +1050,7 @@ WLang内でのRubyメソッドの呼び出しは一般的ではないので、
 
 テンプレートはルーティングハンドラと同じコンテキストの中で評価されます。ルーティングハンドラでセットされたインスタンス変数はテンプレート内で直接使うことができます。
 
-``` ruby
+```ruby
 get '/:id' do
   @foo = Foo.find(params['id'])
   haml '%h1= @foo.name'
@@ -1051,21 +1059,21 @@ end
 
 また、ローカル変数のハッシュで明示的に指定することもできます。
 
-``` ruby
+```ruby
 get '/:id' do
   foo = Foo.find(params['id'])
   haml '%h1= bar.name', :locals => { :bar => foo }
 end
 ```
 
-このやり方は他のテンプレート内で部分テンプレートとして表示する時に典型的に使用されます。
+これは他のテンプレート内で部分テンプレートとして表示する典型的な手法です。
 
 ### `yield`を伴うテンプレートとネストしたレイアウト
 
 レイアウトは通常、`yield`を呼ぶ単なるテンプレートに過ぎません。
 そのようなテンプレートは、既に説明した`:template`オプションを通して使われるか、または次のようなブロックを伴ってレンダリングされます。
 
-``` ruby
+```ruby
 erb :post, :layout => false do
   erb :index
 end
@@ -1075,7 +1083,7 @@ end
 
 レンダリングメソッドにブロックを渡すスタイルは、ネストしたレイアウトを作るために最も役立ちます。
 
-``` ruby
+```ruby
 erb :main_layout, :layout => false do
   erb :admin_layout do
     erb :user
@@ -1085,7 +1093,7 @@ end
 
 これはまた次のより短いコードでも達成できます。
 
-``` ruby
+```ruby
 erb :admin_layout, :layout => :main_layout do
   erb :user
 end
@@ -1095,12 +1103,11 @@ end
 `liquid`, `slim `, `wlang`。
 また汎用の`render`メソッドもブロックを取れます。
 
-
 ### インラインテンプレート(Inline Templates)
 
 テンプレートはソースファイルの最後で定義することもできます。
 
-``` ruby
+```ruby
 require 'sinatra'
 
 get '/' do
@@ -1123,7 +1130,7 @@ __END__
 
 テンプレートはトップレベルの`template`メソッドで定義することもできます。
 
-``` ruby
+```ruby
 template :layout do
   "%html\n  =yield\n"
 end
@@ -1137,9 +1144,9 @@ get '/' do
 end
 ```
 
-「layout」というテンプレートが存在する場合、そのテンプレートファイルは他のテンプレートがレンダリングされる度に使用されます。`:layout => false`で個別に、または`set :haml, :layout => false`でデフォルトとして、レイアウトを無効にすることができます。
+「layout」という名前のテンプレートが存在する場合は、そのテンプレートファイルは他のテンプレートがレンダリングされる度に使用されます。`:layout => false`で個別に、または`set :haml, :layout => false`でデフォルトとして、レイアウトを無効にすることができます。
 
-``` ruby
+```ruby
 get '/' do
   haml :index, :layout => !request.xhr?
 end
@@ -1149,7 +1156,7 @@ end
 
 任意のテンプレートエンジンにファイル拡張子を関連付ける場合は、`Tilt.register`を使います。例えば、Textileテンプレートに`tt`というファイル拡張子を使いたい場合は、以下のようにします。
 
-``` ruby
+```ruby
 Tilt.register :tt, Tilt[:textile]
 ```
 
@@ -1157,7 +1164,7 @@ Tilt.register :tt, Tilt[:textile]
 
 まず、Tiltでそのエンジンを登録し、次にレンダリングメソッドを作ります。
 
-``` ruby
+```ruby
 Tilt.register :myat, MyAwesomeTemplateEngine
 
 helpers do
@@ -1171,11 +1178,27 @@ end
 
 これは、`./views/index.myat`をレンダリングします。Tiltについての詳細は、https://github.com/rtomayko/tilt を参照してください。
 
+### カスタムロジックを使用したテンプレートの探索
+
+オリジナルテンプレートの検索メカニズムを実装するためには、`#find_template`メソッドを実装します。
+
+```ruby
+configure do
+  set :views [ './views/a', './views/b' ]
+end
+
+def find_template(views, name, engine, &block)
+  Array(views).each do |v|
+    super(v, name, engine, &block)
+  end
+end
+```
+
 ## フィルタ(Filters)
 
 beforeフィルタは、リクエストのルーティングと同じコンテキストで各リクエストの前に評価され、それによってリクエストとレスポンスを変更可能にします。フィルタ内でセットされたインスタンス変数はルーティングとテンプレートからアクセスすることができます。
 
-``` ruby
+```ruby
 before do
   @note = 'Hi!'
   request.path_info = '/foo/bar/baz'
@@ -1189,7 +1212,7 @@ end
 
 afterフィルタは、リクエストのルーティングと同じコンテキストで各リクエストの後に評価され、それによってこれもリクエストとレスポンスを変更可能にします。beforeフィルタとルーティング内でセットされたインスタンス変数はafterフィルタからアクセスすることができます。
 
-``` ruby
+```ruby
 after do
   puts response.status
 end
@@ -1199,7 +1222,7 @@ end
 
 フィルタにはオプションとしてパターンを渡すことができ、この場合はリクエストのパスがパターンにマッチした場合にのみフィルタが評価されるようになります。
 
-``` ruby
+```ruby
 before '/protected/*' do
   authenticate!
 end
@@ -1211,7 +1234,7 @@ end
 
 ルーティング同様、フィルタもまた条件を取ることができます。
 
-``` ruby
+```ruby
 before :agent => /Songbird/ do
   # ...
 end
@@ -1225,7 +1248,7 @@ end
 
 トップレベルの`helpers`メソッドを使用してルーティングハンドラやテンプレートで使うヘルパーメソッドを定義できます。
 
-``` ruby
+```ruby
 helpers do
   def bar(name)
     "#{name}bar"
@@ -1239,7 +1262,7 @@ end
 
 あるいは、ヘルパーメソッドをモジュール内で個別に定義することもできます。
 
-``` ruby
+```ruby
 module FooUtils
   def foo(name) "#{name}foo" end
 end
@@ -1253,12 +1276,11 @@ helpers FooUtils, BarUtils
 
 その効果は、アプリケーションクラスにモジュールをインクルードするのと同じです。
 
-
 ### セッションの使用
 
-セッションはリクエスト間での状態維持のために使用されます。その起動により、ユーザセッションごとに一つのセッションハッシュが与えられます。
+セッションはリクエスト間での状態維持のために使用されます。セッションを有効化すると、ユーザセッションごとに一つのセッションハッシュが与えられます。
 
-``` ruby
+```ruby
 enable :sessions
 
 get '/' do
@@ -1272,7 +1294,7 @@ end
 
 ノート: `enable :sessions`は実際にはすべてのデータをクッキーに保持します。これは必ずしも期待通りのものにならないかもしれません（例えば、大量のデータを保持することでトラフィックが増大するなど）。Rackセッションミドルウェアの利用が可能であり、その場合は`enable :sessions`を呼ばずに、選択したミドルウェアを他のミドルウェアのときと同じようにして取り込んでください。
 
-``` ruby
+```ruby
 use Rack::Session::Pool, :expire_after => 2592000
 
 get '/' do
@@ -1286,57 +1308,89 @@ end
 
 セキュリティ向上のため、クッキー内のセッションデータはセッション秘密鍵(session secret)で署名されます。Sinatraによりランダムな秘密鍵が個別に生成されます。しかし、この秘密鍵はアプリケーションの立ち上げごとに変わってしまうので、すべてのアプリケーションのインスタンスで共有できる秘密鍵をセットしたくなるかもしれません。
 
-``` ruby
+```ruby
 set :session_secret, 'super secret'
 ```
 
 更に、設定変更をしたい場合は、`sessions`の設定においてオプションハッシュを保持することもできます。
 
-``` ruby
+```ruby
 set :sessions, :domain => 'foo.com'
 ```
 
 foo.comのサブドメイン上のアプリ間でセッションを共有化したいときは、代わりにドメインの前に *.* を付けます。
 
-``` ruby
+```ruby
 set :sessions, :domain => '.foo.com'
 ```
 
+#### セッションミドルウェアの選択
+
+`enable :sessions`とすることで、クッキー内の全てのデータを実際に保存してしまうことに注意してください。
+これは、あなたが望む挙動ではない（例えば、大量のデータを保存することでトラフィックが増大してしまう）かもしれません。
+あなたは、次のいずれかの方法によって、任意のRackセッションミドルウェアを使用することができます。
+
+```ruby
+enable :sessions
+set :session_store, Rack::Session::Pool
+```
+
+オプションのハッシュを設定するためには、次のようにします。
+
+```ruby
+set :sessions, :expire_after => 2592000
+set :session_store, Rack::Session::Pool
+```
+
+他の方法は`enable :sessions`を**しない**で、他のミドルウェアの選択と同様にあなた自身でミドルウェアを選択することです。
+
+この方法を選択する場合は、セッションベースの保護は**デフォルトで有効にならない**ということに注意することが重要です。
+
+これを満たすためのRackミドルウェアを追加することが必要になります。
+
+```ruby
+use Rack::Session::Pool, :expire_after => 2592000
+use Rack::Protection::RemoteToken
+use Rack::Protection::SessionHijacking
+```
+
+より詳しい情報は、「攻撃防御に対する設定」の項を参照してください。
+
 ### 停止(Halting)
 
 フィルタまたはルーティング内で直ちにリクエストを止める場合
 
-``` ruby
+```ruby
 halt
 ```
 
 この際、ステータスを指定することもできます。
 
-``` ruby
+```ruby
 halt 410
 ```
 
 body部を指定することも、
 
-``` ruby
+```ruby
 halt 'ここにbodyを書く'
 ```
 
 ステータスとbody部を指定することも、
 
-``` ruby
+```ruby
 halt 401, '立ち去れ!'
 ```
 
 ヘッダを付けることもできます。
 
-``` ruby
+```ruby
 halt 402, {'Content-Type' => 'text/plain'}, 'リベンジ'
 ```
 
 もちろん、テンプレートを`halt`に結びつけることも可能です。
 
-``` ruby
+```ruby
 halt erb(:error)
 ```
 
@@ -1344,7 +1398,7 @@ halt erb(:error)
 
 ルーティングは`pass`を使って次のルーティングに飛ばすことができます。
 
-``` ruby
+```ruby
 get '/guess/:who' do
   pass unless params['who'] == 'Frank'
   "見つかっちゃった!"
@@ -1359,9 +1413,10 @@ end
 
 ### 別ルーティングの誘発
 
-`pass`を使ってルーティングを飛ばすのではなく、他のルーティングを呼んだ結果を得たいというときがあります。これを実現するには`call`を使えばいいです。
+`pass`を使ってルーティングを飛ばすのではなく、他のルーティングを呼んだ結果を得たいという場合があります。
+これは`call`を使用することで実現できます。
 
-``` ruby
+```ruby
 get '/foo' do
   status, headers, body = call env.merge("PATH_INFO" => '/bar')
   [status, headers, body.map(&:upcase)]
@@ -1372,18 +1427,17 @@ get '/bar' do
 end
 ```
 
-ノート: 先の例において、テストを楽にしパフォーマンスを改善するには、`"bar"`を単にヘルパーに移し、`/foo`および`/bar`から使えるようにするのがいいです。
+ノート: 先の例において、テストを楽にしパフォーマンスを改善するには、`"bar"`を単にヘルパーに移し、`/foo`および`/bar`から使えるようにしたほうが良いです。
 
 リクエストが、その複製物でない同じアプリケーションのインスタンスに送られるようにしたいときは、`call`に代えて`call!`を使ってください。
 
-`call`についての詳細はRackの仕様書を参照してください。
-
+`call`についての詳細はRackの仕様を参照してください。
 
 ### ボディ、ステータスコードおよびヘッダの設定
 
 ステータスコードおよびレスポンスボディを、ルーティングブロックの戻り値にセットすることが可能であり、これは推奨されています。しかし、あるケースでは実行フローの任意のタイミングでボディをセットしたくなるかもしれません。`body`ヘルパーメソッドを使えばそれができます。そうすると、それ以降、ボディにアクセスするためにそのメソッドを使うことができるようになります。
 
-``` ruby
+```ruby
 get '/foo' do
   body "bar"
 end
@@ -1397,7 +1451,7 @@ end
 
 ボディと同様に、ステータスコードおよびヘッダもセットできます。
 
-``` ruby
+```ruby
 get '/foo' do
   status 418
   headers \
@@ -1413,7 +1467,7 @@ end
 
 レスポンスボディの部分を未だ生成している段階で、データを送り出したいということがあります。極端な例では、クライアントがコネクションを閉じるまでデータを送り続けたいことがあります。`stream`ヘルパーを使えば、独自ラッパーを作る必要はありません。
 
-``` ruby
+```ruby
 get '/' do
   stream do |out|
     out << "それは伝 -\n"
@@ -1425,13 +1479,13 @@ get '/' do
 end
 ```
 
-これはストリーミングAPI、[Server Sent Events](http://dev.w3.org/html5/eventsource/)の実装を可能にし、[WebSockets](http://en.wikipedia.org/wiki/WebSocket)の土台に使うことができます。また、一部のコンテンツが遅いリソースに依存しているときに、スループットを上げるために使うこともできます。
+これはストリーミングAPI、[Server Sent Events](https://w3c.github.io/eventsource/)の実装を可能にし、[WebSockets](https://en.wikipedia.org/wiki/WebSocket)の土台に使うことができます。また、一部のコンテンツが遅いリソースに依存しているときに、スループットを上げるために使うこともできます。
 
-ノート: ストリーミングの挙動、特に並行リクエスト(cuncurrent requests)の数は、アプリケーションを提供するのに使われるWebサーバに強く依存します。WEBRickを含むいくつかのサーバは、ストリーミングを全くサポートしません。サーバがストリーミングをサポートしない場合、ボディは`stream`に渡されたブロックの実行が終了した後、一度に全部送られることになります。ストリーミングは、Shotgunを使った場合は全く動作しません。
+ノート: ストリーミングの挙動、特に並行リクエスト(cuncurrent requests)の数は、アプリケーションを提供するのに使われるWebサーバに強く依存します。いくつかのサーバは、ストリーミングを全くサポートしません。サーバがストリーミングをサポートしない場合、ボディは`stream`に渡されたブロックの実行が終了した後、一度に全部送られることになります。ストリーミングは、Shotgunを使った場合は全く動作しません。
 
 オプション引数が`keep_open`にセットされている場合、ストリームオブジェクト上で`close`は呼ばれず、実行フローの任意の遅れたタイミングでユーザがこれを閉じることを可能にします。これはThinやRainbowsのようなイベント型サーバ上でしか機能しません。他のサーバでは依然ストリームは閉じられます。
 
-``` ruby
+```ruby
 # ロングポーリング
 
 set :server, :thin
@@ -1460,12 +1514,13 @@ post '/message' do
 end
 ```
 
+クライアントはソケットに書き込もうとしている接続を閉じることも可能です。そのため、記述しようとする前に`out.closed?`をチェックすることを勧めます。
+
 ### ロギング(Logging)
 
 リクエストスコープにおいて、`logger`ヘルパーは`Logger`インスタンスを作り出します。
 
-
-``` ruby
+```ruby
 get '/' do
   logger.info "loading data"
   # ...
@@ -1476,7 +1531,7 @@ end
 
 ノート: ロギングは、`Sinatra::Application`に対してのみデフォルトで有効にされているので、`Sinatra::Base`を継承している場合は、ユーザがこれを有効化する必要があります。
 
-``` ruby
+```ruby
 class MyApp < Sinatra::Base
   configure :production, :development do
     enable :logging
@@ -1488,9 +1543,9 @@ end
 
 ### MIMEタイプ(Mime Types)
 
-`send_file`か静的ファイルを使う時、SinatraがMIMEタイプを理解できない場合があります。その時は `mime_type` を使ってファイル拡張子毎に登録して下さい。
+`send_file`か静的ファイルを使う時、SinatraがMIMEタイプを理解できない場合があります。その時は `mime_type` を使ってファイル拡張子毎に登録してください。
 
-``` ruby
+```ruby
 configure do
   mime_type :foo, 'text/foo'
 end
@@ -1498,7 +1553,7 @@ end
 
 これは`content_type`ヘルパーで利用することができます:
 
-``` ruby
+```ruby
 get '/' do
   content_type :foo
   "foo foo foo"
@@ -1509,7 +1564,7 @@ end
 
 URLを生成するためには`url`ヘルパーメソッドが使えます。Hamlではこのようにします。
 
-``` ruby
+```ruby
 %a{:href => url('/foo')} foo
 ```
 
@@ -1521,7 +1576,7 @@ URLを生成するためには`url`ヘルパーメソッドが使えます。Ham
 
 `redirect` ヘルパーメソッドを使うことで、ブラウザをリダイレクトさせることができます。
 
-``` ruby
+```ruby
 get '/foo' do
   redirect to('/bar')
 end
@@ -1529,14 +1584,14 @@ end
 
 他に追加されるパラメータは、`halt`に渡される引数と同様に取り扱われます。
 
-``` ruby
+```ruby
 redirect to('/bar'), 303
-redirect 'http://google.com', 'wrong place, buddy'
+redirect 'http://www.google.com/', 'wrong place, buddy'
 ```
 
 また、`redirect back`を使えば、簡単にユーザが来たページへ戻るリダイレクトを作れます。
 
-``` ruby
+```ruby
 get '/foo' do
   "<a href='/bar'>do something</a>"
 end
@@ -1549,14 +1604,13 @@ end
 
 redirectに引数を渡すには、それをクエリーに追加するか、
 
-
-``` ruby
+```ruby
 redirect to('/bar?sum=42')
 ```
 
 または、セッションを使います。
 
-``` ruby
+```ruby
 enable :sessions
 
 get '/foo' do
@@ -1575,7 +1629,7 @@ end
 
 キャッシュ制御ヘッダ(Cache-Control header)は、次のように簡単に設定できます。
 
-``` ruby
+```ruby
 get '/' do
   cache_control :public
   "キャッシュしました!"
@@ -1584,7 +1638,7 @@ end
 
 ヒント: キャッシングをbeforeフィルタ内で設定します。
 
-``` ruby
+```ruby
 before do
   cache_control :public, :must_revalidate, :max_age => 60
 end
@@ -1592,7 +1646,7 @@ end
 
 `expires`ヘルパーを対応するヘッダに使っている場合は、キャッシュ制御は自動で設定されます。
 
-``` ruby
+```ruby
 before do
   expires 500, :public, :must_revalidate
 end
@@ -1600,7 +1654,7 @@ end
 
 キャッシュを適切に使うために、`etag`または`last_modified`を使うことを検討してください。これらのヘルパーを、重い仕事をさせる *前* に呼ぶことを推奨します。そうすれば、クライアントが既にキャッシュに最新版を持っている場合はレスポンスを直ちに破棄するようになります。
 
-``` ruby
+```ruby
 get '/article/:id' do
   @article = Article.find params['id']
   last_modified @article.updated_at
@@ -1609,16 +1663,15 @@ get '/article/:id' do
 end
 ```
 
-また、[weak ETag](http://ja.wikipedia.org/wiki/HTTP_ETag#Strong_and_weak_validation)を使うこともできます。
+また、[weak ETag](https://ja.wikipedia.org/wiki/HTTP_ETag#Strong_and_weak_validation)を使うこともできます。
 
-``` ruby
+```ruby
 etag @article.sha1, :weak
 ```
 
 これらのヘルパーは、キャッシングをしてくれませんが、必要な情報をキャッシュに与えてくれます。もし手早いリバースプロキシキャッシングの解決策をお探しなら、 [rack-cache](https://github.com/rtomayko/rack-cache)を試してください。
 
-
-``` ruby
+```ruby
 require "rack/cache"
 require "sinatra"
 
@@ -1635,7 +1688,7 @@ end
 
 RFC 2616によれば、アプリケーションは、If-MatchまたはIf-None-Matchヘッダが`*`に設定されている場合には、要求されたリソースが既に存在するか否かに応じて、異なる振る舞いをすべきとなっています。Sinatraは、getのような安全なリクエストおよびputのような冪等なリクエストは既に存在しているものとして仮定し、一方で、他のリソース(例えば、postリクエスト)は新たなリソースとして取り扱われるよう仮定します。この振る舞いは、`:new_resource`オプションを渡すことで変更できます。
 
-``` ruby
+```ruby
 get '/create' do
   etag '', :new_resource => true
   Article.create
@@ -1645,7 +1698,7 @@ end
 
 ここでもWeak ETagを使いたい場合は、`:kind`オプションを渡してください。
 
-``` ruby
+```ruby
 etag '', :new_resource => true, :kind => :weak
 ```
 
@@ -1653,7 +1706,7 @@ etag '', :new_resource => true, :kind => :weak
 
 ファイルを送信するには、`send_file`ヘルパーメソッドを使います。
 
-``` ruby
+```ruby
 get '/' do
   send_file 'foo.png'
 end
@@ -1661,7 +1714,7 @@ end
 
 これはオプションを取ることもできます。
 
-``` ruby
+```ruby
 send_file 'foo.png', :type => :jpg
 ```
 
@@ -1694,12 +1747,11 @@ send_file 'foo.png', :type => :jpg
     </dd>
 </dl>
 
-
 ### リクエストオブジェクトへのアクセス
 
 受信するリクエストオブジェクトは、`request`メソッドを通じてリクエストレベル(フィルタ、ルーティング、エラーハンドラ)からアクセスすることができます。
 
-``` ruby
+```ruby
 # アプリケーションが http://example.com/example で動作している場合
 get '/foo' do
   t = %w[text/css text/html application/javascript]
@@ -1734,7 +1786,7 @@ end
 
 `script_name`や`path_info`などのオプションは次のように利用することもできます。
 
-``` ruby
+```ruby
 before { request.path_info = "/" }
 
 get "/" do
@@ -1744,7 +1796,7 @@ end
 
 `request.body`はIOまたはStringIOのオブジェクトです。
 
-``` ruby
+```ruby
 post "/api" do
   request.body.rewind  # 既に読まれているときのため
   data = JSON.parse request.body.read
@@ -1756,7 +1808,7 @@ end
 
 `attachment`ヘルパーを使って、レスポンスがブラウザに表示されるのではなく、ディスクに保存されることをブラウザに対し通知することができます。
 
-``` ruby
+```ruby
 get '/' do
   attachment
   "保存しました!"
@@ -1765,7 +1817,7 @@ end
 
 ファイル名を渡すこともできます。
 
-``` ruby
+```ruby
 get '/' do
   attachment "info.txt"
   "保存しました!"
@@ -1776,7 +1828,7 @@ end
 
 Sinatraは`time_for`ヘルパーメソッドを提供しており、それは与えられた値からTimeオブジェクトを生成します。これはまた`DateTime`、`Date`および類似のクラスを変換できます。
 
-``` ruby
+```ruby
 get '/' do
   pass if Time.now > time_for('Dec 23, 2012')
   "まだ時間がある"
@@ -1785,7 +1837,7 @@ end
 
 このメソッドは、`expires`、`last_modified`といった種類のものの内部で使われています。そのため、アプリケーションにおいて、`time_for`をオーバーライドすることでそれらのメソッドの挙動を簡単に拡張できます。
 
-``` ruby
+```ruby
 helpers do
   def time_for(value)
     case value
@@ -1807,7 +1859,7 @@ end
 
 `find_template`ヘルパーは、レンダリングのためのテンプレートファイルを見つけるために使われます。
 
-``` ruby
+```ruby
 find_template settings.views, 'foo', Tilt[:haml] do |file|
   puts "could be #{file}"
 end
@@ -1816,7 +1868,7 @@ end
 この例はあまり有益ではありません。しかし、このメソッドを、独自の探索機構で働くようオーバーライドするなら有益になります。例えば、複数のビューディレクトリを使えるようにしたいときがあります。
 
 
-``` ruby
+```ruby
 set :views, ['views', 'templates']
 
 helpers do
@@ -1828,7 +1880,7 @@ end
 
 他の例としては、異なるエンジン用の異なるディレクトリを使う場合です。
 
-``` ruby
+```ruby
 set :views, :sass => 'views/sass', :haml => 'templates', :default => 'views'
 
 helpers do
@@ -1848,7 +1900,7 @@ end
 
 どの環境でも起動時に１回だけ実行されます。
 
-``` ruby
+```ruby
 configure do
   # １つのオプションをセット
   set :option, 'value'
@@ -1867,9 +1919,9 @@ configure do
 end
 ```
 
-環境設定(`RACK_ENV`環境変数)が`:production`に設定されている時だけ実行する方法:
+環境設定(`APP_ENV`環境変数)が`:production`に設定されている時だけ実行する方法:
 
-``` ruby
+```ruby
 configure :production do
   ...
 end
@@ -1877,7 +1929,7 @@ end
 
 環境設定が`:production`か`:test`に設定されている時だけ実行する方法:
 
-``` ruby
+```ruby
 configure :production, :test do
   ...
 end
@@ -1885,7 +1937,7 @@ end
 
 設定したオプションには`settings`からアクセスできます:
 
-``` ruby
+```ruby
 configure do
   set :foo, 'bar'
 end
@@ -1899,26 +1951,27 @@ end
 
 ### 攻撃防御に対する設定
 
-Sinatraは、[Rack::Protection](https://github.com/rkh/rack-protection#readme)を使って、アプリケーションを多発する日和見的攻撃から守っています。この挙動は簡単に無効化できます(これはアプリケーションを大量の脆弱性攻撃に晒すことになります)。
+Sinatraは[Rack::Protection](https://github.com/sinatra/rack-protection#readme)を使用することで、アプリケーションを一般的な日和見的攻撃から守っています。これは簡単に無効化できます（が、アプリケーションに大量の一般的な脆弱性を埋め込むことになってしまいます）。
 
-``` ruby
+```ruby
 disable :protection
 ```
 
-単一の防御層を外すためには、`protection`をオプションハッシュにセットします。
+ある1つの防御を無効にするには、`protection`にハッシュでオプションを指定します。
 
-``` ruby
+```ruby
 set :protection, :except => :path_traversal
 ```
-また配列を渡して、複数の防御を無効にすることもできます。
 
-``` ruby
+配列を渡すことで、複数の防御を無効にすることもできます。
+
+```ruby
 set :protection, :except => [:path_traversal, :session_hijacking]
 ```
 
 デフォルトでSinatraは、`:sessions`が有効になっている場合、セッションベースの防御だけを設定します。しかし、自身でセッションを設定したい場合があります。その場合は、`:session`オプションを渡すことにより、セッションベースの防御を設定することができます。
 
-``` ruby
+```ruby
 use Rack::Session::Pool
 set :protection, :session => true
 ```
@@ -1957,7 +2010,7 @@ set :protection, :session => true
 
   <dt>environment</dt>
   <dd>
-    現在の環境。デフォルトは<tt>ENV['RACK_ENV']</tt>、それが無い場合は<tt>"development"</tt>。
+    現在の環境。デフォルトは<tt>ENV['APP_ENV']</tt>、それが無い場合は<tt>"development"</tt>。
   </dd>
 
   <dt>logging</dt>
@@ -2069,17 +2122,17 @@ set :protection, :session => true
 
 ## 環境設定(Environments)
 
-３種類の既定環境、`"development"`、`"production"`および`"test"`があります。環境は、`RACK_ENV`環境変数を通して設定できます。デフォルト値は、`"development"`です。`"development"`環境において、すべてのテンプレートは、各リクエスト間で再ロードされ、そして、特別の`not_found`および`error`ハンドラがブラウザにスタックトレースを表示します。`"production"`および`"test"`環境においては、テンプレートはデフォルトでキャッシュされます。
+3種類の既定環境、`"development"`、`"production"`および`"test"`があります。環境は、`APP_ENV`環境変数を通して設定できます。デフォルト値は、`"development"`です。`"development"`環境において、すべてのテンプレートは、各リクエスト間で再ロードされ、そして、特別の`not_found`および`error`ハンドラがブラウザにスタックトレースを表示します。`"production"`および`"test"`環境においては、テンプレートはデフォルトでキャッシュされます。
 
-異なる環境を走らせるには、`RACK_ENV`環境変数を設定します。
+異なる環境を走らせるには、`APP_ENV`環境変数を設定します。
 
-``` shell
-RACK_ENV=production ruby my_app.rb
+```shell
+APP_ENV=production ruby my_app.rb
 ```
 
 既定メソッド、`development?`、`test?`および`production?`を、現在の環境設定を確認するために使えます。
 
-``` ruby
+```ruby
 get '/' do
   if settings.development?
     "development!"
@@ -2097,7 +2150,7 @@ end
 
 `Sinatra::NotFound`例外が発生したとき、またはレスポンスのステータスコードが404のときに、`not_found`ハンドラが発動します。
 
-``` ruby
+```ruby
 not_found do
   'ファイルが存在しません'
 end
@@ -2105,9 +2158,16 @@ end
 
 ### エラー(Error)
 
-`error`ハンドラはルーティングブロックまたはフィルタ内で例外が発生したときはいつでも発動します。例外オブジェクトはRack変数`sinatra.error`から取得できます。
+`error`ハンドラはルーティングブロックまたはフィルタ内で例外が発生したときはいつでも発動します。
+しかし、環境設定がdevelopmentの場合は`:after_handler`を設定している場合のみ発動するようになります。
+
+```ruby
+set :show_exceptions, :after_handler
+```
+
+例外オブジェクトはRack変数`sinatra.error`から取得できます。
 
-``` ruby
+```ruby
 error do
   'エラーが発生しました。 - ' + env['sinatra.error'].message
 end
@@ -2115,7 +2175,7 @@ end
 
 エラーをカスタマイズする場合は、
 
-``` ruby
+```ruby
 error MyCustomError do
   'エラーメッセージ...' + env['sinatra.error'].message
 end
@@ -2123,7 +2183,7 @@ end
 
 と書いておいて、下記のように呼び出します。
 
-``` ruby
+```ruby
 get '/' do
   raise MyCustomError, '何かがまずかったようです'
 end
@@ -2137,7 +2197,7 @@ end
 
 あるいは、ステータスコードに対応するエラーハンドラを設定することもできます。
 
-``` ruby
+```ruby
 error 403 do
   'Access forbidden'
 end
@@ -2149,7 +2209,7 @@ end
 
 範囲指定もできます。
 
-``` ruby
+```ruby
 error 400..510 do
   'Boom'
 end
@@ -2157,14 +2217,13 @@ end
 
 Sinatraを開発環境の下で実行している場合は、特別な`not_found`および`error`ハンドラが導入され、これは親切なスタックトレースと追加のデバッギング情報をブラウザに表示します。
 
-
 ## Rackミドルウェア(Rack Middleware)
 
 SinatraはRuby製Webフレームワークのミニマルな標準的インタフェースである[Rack](http://rack.github.io/)上に構築されています。アプリケーションデベロッパーにとってRackにおける最も興味深い機能は、「ミドルウェア(middleware)」をサポートしていることであり、これは、サーバとアプリケーションとの間に置かれ、HTTPリクエスト/レスポンスを監視および/または操作することで、各種の汎用的機能を提供するコンポーネントです。
 
 Sinatraはトップレベルの`use`メソッドを通して、Rackミドルウェアパイプラインの構築を楽にします。
 
-``` ruby
+```ruby
 require 'sinatra'
 require 'my_custom_middleware'
 
@@ -2176,9 +2235,9 @@ get '/hello' do
 end
 ```
 
-`use`の文法は、[Rack::Builder](http://rubydoc.info/github/rack/rack/master/Rack/Builder)DSLで定義されているそれ（rackupファイルで最もよく使われる）と同じです。例えば `use`メソッドは複数の引数、そしてブロックも取ることができます。
+`use`の文法は、[Rack::Builder](http://www.rubydoc.info/github/rack/rack/master/Rack/Builder)DSLで定義されているそれ（rackupファイルで最もよく使われる）と同じです。例えば `use`メソッドは複数の引数、そしてブロックも取ることができます。
 
-``` ruby
+```ruby
 use Rack::Auth::Basic do |username, password|
   username == 'admin' && password == 'secret'
 end
@@ -2194,9 +2253,9 @@ Rackは、ロギング、デバッギング、URLルーティング、認証、
 
 ## テスト(Testing)
 
-SinatraでのテストはRackベースのテストライブラリまたはフレームワークを使って書くことができます。[Rack::Test](http://rdoc.info/github/brynary/rack-test/master/frames)をお薦めします。
+SinatraでのテストはRackベースのテストライブラリまたはフレームワークを使って書くことができます。[Rack::Test](http://www.rubydoc.info/github/brynary/rack-test/master/frames)をお薦めします。
 
-``` ruby
+```ruby
 require 'my_sinatra_app'
 require 'minitest/autorun'
 require 'rack/test'
@@ -2218,7 +2277,7 @@ class MyAppTest < Minitest::Test
     assert_equal 'Hello Frank!', last_response.body
   end
 
-  def test_with_rack_env
+  def test_with_user_agent
     get '/', {}, 'HTTP_USER_AGENT' => 'Songbird'
     assert_equal "Songbirdを使ってます!", last_response.body
   end
@@ -2231,7 +2290,7 @@ end
 
 軽量なアプリケーションであれば、トップレベルでアプリケーションを定義していくことはうまくいきますが、再利用性可能なコンポーネント、例えばRackミドルウェア、RailsのMetal、サーバコンポーネントを含むシンプルなライブラリ、あるいはSinatraの拡張プログラムを構築するような場合、これは無視できない欠点を持つものとなります。トップレベルは、軽量なアプリケーションのスタイルにおける設定（例えば、単一のアプリケーションファイル、`./public`および`./views`ディレクトリ、ロギング、例外詳細ページなど）を仮定しています。そこで`Sinatra::Base`の出番です。
 
-``` ruby
+```ruby
 require 'sinatra/base'
 
 class MyApp < Sinatra::Base
@@ -2244,13 +2303,13 @@ class MyApp < Sinatra::Base
 end
 ```
 
-`Sinatra::Base`のサブクラスで利用できるメソッドは、トップレベルDSLで利用できるものと全く同じです。ほとんどのトップレベルで記述されたアプリは、以下の２点を修正することで`Sinatra::Base`コンポーネントに変えることができます。
+`Sinatra::Base`のサブクラスで利用できるメソッドは、トップレベルDSLで利用できるものと全く同じです。ほとんどのトップレベルで記述されたアプリは、以下の2点を修正することで`Sinatra::Base`コンポーネントに変えることができます。
 
 * `sinatra`の代わりに`sinatra/base`を読み込む
   (そうしない場合、SinatraのDSLメソッドの全てがmainの名前空間にインポートされます)
 * ルーティング、エラーハンドラ、フィルタ、オプションを`Sinatra::Base`のサブクラスに書く
 
-`Sinatra::Base`はまっさらです。ビルトインサーバを含む、ほとんどのオプションがデフォルトで無効になっています。利用可能なオプションとその挙動の詳細については[Configuring Settings](http://sinatra.github.com/configuration.html)(英語)をご覧下さい。
+`Sinatra::Base`はまっさらです。ビルトインサーバを含む、ほとんどのオプションがデフォルトで無効になっています。利用可能なオプションとその挙動の詳細については[Configuring Settings](http://www.sinatrarb.com/configuration.html)(英語)をご覧ください。
 
 もしもクラシックスタイルと同じような挙動のアプリケーションをトップレベルで定義させる必要があれば、`Sinatra::Application`をサブクラス化させてください。
 
@@ -2318,7 +2377,7 @@ end
   <tr>
     <td>static</td>
     <td>true</td>
-    <td>false</td>
+    <td>File.exist?(public_folder)</td>
     <td>true</td>
   </tr>
 </table>
@@ -2327,7 +2386,7 @@ end
 
 モジュラーアプリケーションを開始、つまり`run!`を使って開始させる二種類のやり方があります。
 
-``` ruby
+```ruby
 # my_app.rb
 require 'sinatra/base'
 
@@ -2341,13 +2400,13 @@ end
 
 として、次のように起動するか、
 
-``` shell
+```shell
 ruby my_app.rb
 ```
 
 または、Rackハンドラを使えるようにする`config.ru`ファイルを書いて、
 
-``` ruby
+```ruby
 # config.ru (rackupで起動)
 require './my_app'
 run MyApp
@@ -2355,7 +2414,7 @@ run MyApp
 
 起動します。
 
-``` shell
+```shell
 rackup -p 4567
 ```
 
@@ -2363,7 +2422,7 @@ rackup -p 4567
 
 アプリケーションファイルと、
 
-``` ruby
+```ruby
 # app.rb
 require 'sinatra'
 
@@ -2374,7 +2433,7 @@ end
 
 対応する`config.ru`を書きます。
 
-``` ruby
+```ruby
 require './app'
 run Sinatra::Application
 ```
@@ -2396,7 +2455,7 @@ Sinatraは他のRackミドルウェアを利用することができるだけで
 
 このエンドポイントには、別のSinatraアプリケーションまたは他のRackベースのアプリケーション(Rails/Ramaze/Camping/…)が用いられるでしょう。
 
-``` ruby
+```ruby
 require 'sinatra/base'
 
 class LoginScreen < Sinatra::Base
@@ -2431,7 +2490,7 @@ end
 
 新しいアプリケーションを実行時に、定数に割り当てることなく生成したくなる場合があるでしょう。`Sinatra.new`を使えばそれができます。
 
-``` ruby
+```ruby
 require 'sinatra/base'
 my_app = Sinatra.new { get('/') { "hi" } }
 my_app.run!
@@ -2461,7 +2520,7 @@ end
 
 これはまた、Sinatraをミドルウェアとして利用することを極めて簡単にします。
 
-``` ruby
+```ruby
 require 'sinatra/base'
 
 use Sinatra do
@@ -2485,7 +2544,7 @@ run RailsProject::Application
 
 `set`によって作られたオプションはクラスレベルのメソッドです。
 
-``` ruby
+```ruby
 class MyApp < Sinatra::Base
   # アプリケーションスコープの中だよ!
   set :foo, 42
@@ -2516,7 +2575,7 @@ end
 このスコープの内側からは`request`や`session`オブジェクトにアクセスすることができ、`erb`や`haml`のようなレンダリングメソッドを呼び出すことができます。
 リクエストスコープの内側からは、`settings`ヘルパーによってアプリケーションスコープにアクセスすることができます。
 
-``` ruby
+```ruby
 class MyApp < Sinatra::Base
   # アプリケーションスコープの中だよ!
   get '/define_route/:name' do
@@ -2560,7 +2619,7 @@ mixin](https://github.com/sinatra/sinatra/blob/ca06364/lib/sinatra/base.rb#L1609
 
 Sinatraアプリケーションは直接実行できます。
 
-``` shell
+```shell
 ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
 ```
 
@@ -2575,6 +2634,37 @@ ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
 -x # mutex lockを付ける (デフォルトはoff)
 ```
 
+### マルチスレッド
+
+_この[StackOverflow][so-answer]でのKonstantinによる回答を言い換えています。_
+
+Sinatraでは同時実行モデルを負わせることはできませんが、根本的な部分であるThinやPuma、WebrickのようなRackハンドラ(サーバー)部分に委ねることができます。
+Sinatra自身はスレッドセーフであり、もしRackハンドラが同時実行モデルのスレッドを使用していても問題はありません。
+つまり、これはサーバーを起動させる時、特定のRackハンドラに対して正しい起動処理を特定することが出来ます。
+この例はThinサーバーをマルチスレッドで起動する方法のデモです。
+
+```ruby
+# app.rb
+
+require 'sinatra/base'
+
+class App < Sinatra::Base
+  get '/' do
+    "Hello, World"
+  end
+end
+
+App.run!
+```
+
+サーバーを開始するコマンドです。
+
+```
+thin --threaded start
+```
+
+[so-answer]: http://stackoverflow.com/questions/6278817/is-sinatra-multi-threaded/6282999#6282999)
+
 ## 必要環境
 
 次のRubyバージョンが公式にサポートされています。
@@ -2636,7 +2726,7 @@ Sinatraは現在、Cardinal、SmallRuby、BlueRubyまたは1.8.7以前のバー
 
 Sinatraの最新開発版のコードを使いたい場合は、マスターブランチに対してアプリケーションを走らせて構いません。ある程度安定しています。また、適宜プレリリース版gemをpushしているので、
 
-``` shell
+```shell
 gem install sinatra --pre
 ```
 
@@ -2644,11 +2734,11 @@ gem install sinatra --pre
 
 ### Bundlerを使う場合
 
-最新のSinatraでアプリケーションを動作させたい場合には、[Bundler](http://gembundler.com/)を使うのがお薦めのやり方です。
+最新のSinatraでアプリケーションを動作させたい場合には、[Bundler](http://bundler.io)を使うのがお薦めのやり方です。
 
 まず、Bundlerがなければそれをインストールします。
 
-``` shell
+```shell
 gem install bundler
 ```
 
@@ -2667,7 +2757,7 @@ gem 'activerecord', '~> 3.0'  # ActiveRecord 3.xが必要かもしれません
 
 これで、以下のようにしてアプリケーションを起動することができます。
 
-``` shell
+```shell
 bundle exec ruby myapp.rb
 ```
 
@@ -2675,7 +2765,7 @@ bundle exec ruby myapp.rb
 
 ローカルにクローンを作って、`sinatra/lib`ディレクトリを`$LOAD_PATH`に追加してアプリケーションを起動します。
 
-``` shell
+```shell
 cd myapp
 git clone git://github.com/sinatra/sinatra.git
 ruby -I sinatra/lib myapp.rb
@@ -2683,7 +2773,7 @@ ruby -I sinatra/lib myapp.rb
 
 追ってSinatraのソースを更新する方法。
 
-``` shell
+```shell
 cd myapp/sinatra
 git pull
 ```
@@ -2692,7 +2782,7 @@ git pull
 
 Sinatraのgemを自身でビルドすることもできます。
 
-``` shell
+```shell
 git clone git://github.com/sinatra/sinatra.git
 cd sinatra
 rake sinatra.gemspec
@@ -2701,7 +2791,7 @@ rake install
 
 gemをルートとしてインストールする場合は、最後のステップはこうなります。
 
-``` shell
+```shell
 sudo rake install
 ```
 
@@ -2711,14 +2801,14 @@ Sinatraは、[Semantic Versioning](http://semver.org/)におけるSemVerおよ
 
 ## 参考文献
 
-* [プロジェクトサイト](http://sinatra.github.com/) - ドキュメント、ニュース、他のリソースへのリンクがあります。
-* [プロジェクトに参加(貢献)する](http://sinatra.github.com/contributing.html) - バグレポート パッチの送信、サポートなど
-* [Issue tracker](http://github.com/sinatra/sinatra/issues)
-* [Twitter](http://twitter.com/sinatra)
+* [プロジェクトサイト](http://www.sinatrarb.com/) - ドキュメント、ニュース、他のリソースへのリンクがあります。
+* [プロジェクトに参加(貢献)する](http://www.sinatrarb.com/contributing.html) - バグレポート パッチの送信、サポートなど
+* [Issue tracker](https://github.com/sinatra/sinatra/issues)
+* [Twitter](https://twitter.com/sinatra)
 * [メーリングリスト](http://groups.google.com/group/sinatrarb/topics)
 * http://freenode.net上のIRC: [#sinatra](irc://chat.freenode.net/#sinatra)
 * [Sinatra Book](https://github.com/sinatra/sinatra-book/) クックブック、チュートリアル
 * [Sinatra Recipes](http://recipes.sinatrarb.com/) コミュニティによるレシピ集
-* http://rubydoc.info上のAPIドキュメント: [最新版(latest release)用](http://rubydoc.info/gems/sinatra)または[現在のHEAD用](http://rubydoc.info/github/sinatra/sinatra)
-* [CIサーバ](http://travis-ci.org/sinatra/sinatra)
+* http://www.rubydoc.info/上のAPIドキュメント: [最新版(latest release)用](http://www.rubydoc.info/gems/sinatra)または[現在のHEAD用](http://www.rubydoc.info/github/sinatra/sinatra)
+* [CIサーバ](https://travis-ci.org/sinatra/sinatra)
 * [Greenbear Laboratory Rack日本語マニュアル](http://route477.net/w/RackReferenceJa.html)