sinatra 2.0.0 → 2.0.1.rc1

data/README.md

@@ -1,6 +1,6 @@
 # Sinatra
 
-[![Build Status](https://secure.travis-ci.org/sinatra/sinatra.svg)](http://travis-ci.org/sinatra/sinatra)
+[![Build Status](https://secure.travis-ci.org/sinatra/sinatra.svg)](https://travis-ci.org/sinatra/sinatra)
 
 Sinatra is a [DSL](https://en.wikipedia.org/wiki/Domain-specific_language) for
 quickly creating web applications in Ruby with minimal effort:
@@ -28,6 +28,10 @@ ruby myapp.rb
 
 View at: [http://localhost:4567](http://localhost:4567)
 
+The code you changed will not take effect until you restart the server.
+Please restart the server every time you change or use
+[sinatra/reloader](http://www.sinatrarb.com/contrib/reloader).
+
 It is recommended to also run `gem install thin`, which Sinatra will
 pick up if available.
 
@@ -75,9 +79,9 @@ pick up if available.
     * [Filters](#filters)
     * [Helpers](#helpers)
         * [Using Sessions](#using-sessions)
-          * [Session Secret Security](#session-secret-security)
-          * [Session Config](#session-config)
-          * [Choosing Your Own Session Middleware](#choosing-your-own-session-middleware)
+            * [Session Secret Security](#session-secret-security)
+            * [Session Config](#session-config)
+            * [Choosing Your Own Session Middleware](#choosing-your-own-session-middleware)
         * [Halting](#halting)
         * [Passing](#passing)
         * [Triggering Another Route](#triggering-another-route)
@@ -253,11 +257,11 @@ end
 ```
 
 By the way, unless you disable the path traversal attack protection (see
-below), the request path might be modified before matching against your
-routes.
+[below](#configuring-attack-protection)), the request path might be modified before
+matching against your routes.
 
-You may customize the Mustermann options used for a given route by passing in a
-`:mustermann_opts` hash:
+You may customize the [Mustermann](https://github.com/sinatra/mustermann#readme)
+options used for a given route by passing in a `:mustermann_opts` hash:
 
 ```ruby
 get '\A/posts\z', :mustermann_opts => { :type => :regexp, :check_anchors => false } do
@@ -365,7 +369,7 @@ end
 get('/') { Stream.new }
 ```
 
-You can also use the `stream` helper method (described below) to reduce
+You can also use the `stream` helper method ([described below](#streaming-responses)) to reduce
 boiler plate and embed the streaming logic in the route.
 
 ## Custom Route Matchers
@@ -428,7 +432,7 @@ Note that the public directory name is not included in the URL. A file
 `./public/css/style.css` is made available as
 `http://example.com/css/style.css`.
 
-Use the `:static_cache_control` setting (see below) to add
+Use the `:static_cache_control` setting (see [below](#cache-control)) to add
 `Cache-Control` header info.
 
 ## Views / Templates
@@ -638,7 +642,7 @@ get('/') { markdown :index }
   </tr>
 </table>
 
-It also takes a block for inline templates (see example).
+It also takes a block for inline templates (see [example](#inline-templates)).
 
 #### Nokogiri Templates
 
@@ -657,14 +661,14 @@ It also takes a block for inline templates (see example).
   </tr>
 </table>
 
-It also takes a block for inline templates (see example).
+It also takes a block for inline templates (see [example](#inline-templates)).
 
 #### Sass Templates
 
 <table>
   <tr>
     <td>Dependency</td>
-    <td><a href="http://sass-lang.com/" title="sass">sass</a></td>
+    <td><a href="https://sass-lang.com/" title="sass">sass</a></td>
   </tr>
   <tr>
     <td>File Extension</td>
@@ -681,7 +685,7 @@ It also takes a block for inline templates (see example).
 <table>
   <tr>
     <td>Dependency</td>
-    <td><a href="http://sass-lang.com/" title="sass">sass</a></td>
+    <td><a href="https://sass-lang.com/" title="sass">sass</a></td>
   </tr>
   <tr>
     <td>File Extension</td>
@@ -739,8 +743,8 @@ template, you almost always want to pass locals to it.
       Anyone of:
         <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>,
+        <a href="https://github.com/ged/bluecloth" title="BlueCloth">BlueCloth</a>,
+        <a href="https://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
         <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
     </td>
   </tr>
@@ -890,7 +894,7 @@ almost always want to pass locals to it.
 <table>
   <tr>
     <td>Dependency</td>
-    <td><a href="http://markaby.github.io/" title="Markaby">Markaby</a></td>
+    <td><a href="https://markaby.github.io/" title="Markaby">Markaby</a></td>
   </tr>
   <tr>
     <td>File Extension</td>
@@ -902,7 +906,7 @@ almost always want to pass locals to it.
   </tr>
 </table>
 
-It also takes a block for inline templates (see example).
+It also takes a block for inline templates (see [example](#inline-templates)).
 
 #### RABL Templates
 
@@ -1019,7 +1023,7 @@ template than for the layout by passing the `:layout_engine` option.
       <a href="https://github.com/josh/ruby-coffee-script" title="Ruby CoffeeScript">
         CoffeeScript
       </a> and a
-      <a href="https://github.com/sstephenson/execjs/blob/master/README.md#readme" title="ExecJS">
+      <a href="https://github.com/sstephenson/execjs" title="ExecJS">
         way to execute javascript
       </a>
     </td>
@@ -1043,7 +1047,7 @@ template than for the layout by passing the `:layout_engine` option.
       <a href="https://github.com/forgecrafted/ruby-stylus" title="Ruby Stylus">
         Stylus
       </a> and a
-      <a href="https://github.com/sstephenson/execjs/blob/master/README.md#readme" title="ExecJS">
+      <a href="https://github.com/sstephenson/execjs" title="ExecJS">
         way to execute javascript
       </a>
     </td>
@@ -1117,7 +1121,7 @@ present(resource);
 <table>
   <tr>
     <td>Dependency</td>
-    <td><a href="https://github.com/blambeau/wlang/" title="WLang">WLang</a></td>
+    <td><a href="https://github.com/blambeau/wlang" title="WLang">WLang</a></td>
   </tr>
   <tr>
     <td>File Extension</td>
@@ -1273,8 +1277,8 @@ get '/' do
 end
 ```
 
-Renders `./views/index.myat`. See https://github.com/rtomayko/tilt to
-learn more about Tilt.
+Renders `./views/index.myat`. Learn more about
+[Tilt](https://github.com/rtomayko/tilt#readme).
 
 ### Using Custom Logic for Template Lookup
 
@@ -1435,8 +1439,8 @@ $ ruby -e "require 'securerandom'; puts SecureRandom.hex(64)"
 
 **Session Secret Generation (Bonus Points)**
 
-Use the [sysrandom gem](https://github.com/cryptosphere/sysrandom) to prefer
-use of system RNG facilities to generate random values instead of
+Use the [sysrandom gem](https://github.com/cryptosphere/sysrandom#readme) to
+prefer use of system RNG facilities to generate random values instead of
 userspace `OpenSSL` which MRI Ruby currently defaults to:
 
 ```text
@@ -1466,7 +1470,7 @@ Setup your app config to fail-safe to a secure random secret
 if the `SESSION_SECRET` environment variable is not available.
 
 For bonus points use the [sysrandom
-gem](https://github.com/cryptosphere/sysrandom) here as well:
+gem](https://github.com/cryptosphere/sysrandom#readme) here as well:
 
 ```ruby
 require 'securerandom'
@@ -1523,7 +1527,7 @@ use Rack::Protection::RemoteToken
 use Rack::Protection::SessionHijacking
 ```
 
-See 'Configuring attack protection' for more information.
+See '[Configuring attack protection](#configuring-attack-protection)' for more information.
 
 ### Halting
 
@@ -1625,7 +1629,7 @@ end
 ```
 
 It is also possible to pass a block to `body`, which will be executed by the
-Rack handler (this can be used to implement streaming, see "Return Values").
+Rack handler (this can be used to implement streaming, [see "Return Values"](#return-values)).
 
 Similar to the body, you can also set the status code and headers:
 
@@ -1634,7 +1638,7 @@ get '/foo' do
   status 418
   headers \
     "Allow"   => "BREW, POST, GET, PROPFIND, WHEN",
-    "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
+    "Refresh" => "Refresh: 20; https://ietf.org/rfc/rfc2324.txt"
   body "I'm a tea pot!"
 end
 ```
@@ -1773,7 +1777,7 @@ Haml:
 
 It takes reverse proxies and Rack routers into account, if present.
 
-This method is also aliased to `to` (see below for an example).
+This method is also aliased to `to` (see [below](#browser-redirect) for an example).
 
 ### Browser Redirect
 
@@ -1881,7 +1885,7 @@ etag @article.sha1, :weak
 These helpers will not do any caching for you, but rather feed the necessary
 information to your cache. If you are looking for a quick
 reverse-proxy caching solution, try
-[rack-cache](https://github.com/rtomayko/rack-cache):
+[rack-cache](https://github.com/rtomayko/rack-cache#readme):
 
 ```ruby
 require "rack/cache"
@@ -1896,7 +1900,7 @@ get '/' do
 end
 ```
 
-Use the `:static_cache_control` setting (see below) to add
+Use the `:static_cache_control` setting (see [below](#cache-control)) to add
 `Cache-Control` header info to static files.
 
 According to RFC 2616, your application should behave differently if the
@@ -2208,7 +2212,7 @@ set :protection, :except => [:path_traversal, :session_hijacking]
 ```
 
 By default, Sinatra will only set up session based protection if `:sessions`
-have been enabled. See 'Using Sessions'. Sometimes you may want to set up
+have been enabled. See '[Using Sessions](#using-sessions)'. Sometimes you may want to set up
 sessions "outside" of the Sinatra app, such as in the config.ru or with a
 separate `Rack::Builder` instance. In that case you can still set up session
 based protection by passing the `:session` option:
@@ -2353,6 +2357,16 @@ set :protection, :session => true
       priority, default depends on Ruby implementation.
     </dd>
 
+  <dt>server_settings</dt>
+    <dd>
+      If you are using a WEBrick web server, presumably for your development
+      environment, you can pass a hash of options to <tt>server_settings</tt>,
+      such as <tt>SSLEnable</tt> or <tt>SSLVerifyClient</tt>. However, web
+      servers such as Puma and Thin do not support this, so you can set
+      <tt>server_settings</tt> by defining it as a method when you call
+      <tt>configure</tt>.
+    </dd>
+
   <dt>sessions</dt>
     <dd>
       Enable cookie-based sessions support using
@@ -2531,7 +2545,7 @@ and additional debugging information in your browser.
 
 ## Rack Middleware
 
-Sinatra rides on [Rack](http://rack.github.io/), a minimal standard
+Sinatra rides on [Rack](https://rack.github.io/), a minimal standard
 interface for Ruby web frameworks. One of Rack's most interesting
 capabilities for application developers is support for "middleware" --
 components that sit between the server and your application monitoring
@@ -2571,7 +2585,7 @@ typically don't have to `use` them explicitly.
 
 You can find useful middleware in
 [rack](https://github.com/rack/rack/tree/master/lib/rack),
-[rack-contrib](https://github.com/rack/rack-contrib#readm),
+[rack-contrib](https://github.com/rack/rack-contrib#readme),
 or in the [Rack wiki](https://github.com/rack/rack/wiki/List-of-Middleware).
 
 ## Testing
@@ -2995,7 +3009,9 @@ Options are:
 
 ### Multi-threading
 
-_Paraphrasing from [this StackOverflow answer][so-answer] by Konstantin_
+_Paraphrasing from
+[this StackOverflow answer](https://stackoverflow.com/a/6282999/5245129)
+by Konstantin_
 
 Sinatra doesn't impose any concurrency model, but leaves that to the
 underlying Rack handler (server) like Thin, Puma or WEBrick. Sinatra
@@ -3026,9 +3042,6 @@ To start the server, the command would be:
 thin --threaded start
 ```
 
-
-[so-answer]: http://stackoverflow.com/questions/6278817/is-sinatra-multi-threaded/6282999#6282999)
-
 ## Requirement
 
 The following Ruby versions are officially supported:
@@ -3097,7 +3110,7 @@ to get some of the latest features.
 ### With Bundler
 
 If you want to run your application with the latest Sinatra, using
-[Bundler](http://bundler.io) is the recommended way.
+[Bundler](https://bundler.io) is the recommended way.
 
 First, install bundler, if you haven't:
 
@@ -3127,7 +3140,7 @@ bundle exec ruby myapp.rb
 
 ## Versioning
 
-Sinatra follows [Semantic Versioning](http://semver.org/), both SemVer and
+Sinatra follows [Semantic Versioning](https://semver.org/), both SemVer and
 SemVerTag.
 
 ## Further Reading
@@ -3138,14 +3151,14 @@ SemVerTag.
   help? Have a patch?
 * [Issue tracker](https://github.com/sinatra/sinatra/issues)
 * [Twitter](https://twitter.com/sinatra)
-* [Mailing List](http://groups.google.com/group/sinatrarb/topics)
-* IRC: [#sinatra](irc://chat.freenode.net/#sinatra) on http://freenode.net
-* [Sinatra & Friends](https://sinatrarb.slack.com) on Slack and see
-  [here](https://sinatra-slack.herokuapp.com/) for an invite.
-* [Sinatra Book](https://github.com/sinatra/sinatra-book/) Cookbook Tutorial
-* [Sinatra Recipes](http://recipes.sinatrarb.com/) Community
-  contributed recipes
+* [Mailing List](https://groups.google.com/forum/#!forum/sinatrarb)
+* IRC: [#sinatra](irc://chat.freenode.net/#sinatra) on [Freenode](https://freenode.net)
+* [Sinatra & Friends](https://sinatrarb.slack.com) on Slack
+  ([get an invite](https://sinatra-slack.herokuapp.com/))
+* [Sinatra Book](https://github.com/sinatra/sinatra-book) - Cookbook Tutorial
+* [Sinatra Recipes](http://recipes.sinatrarb.com/) - Community contributed
+  recipes
 * API documentation for the [latest release](http://www.rubydoc.info/gems/sinatra)
   or the [current HEAD](http://www.rubydoc.info/github/sinatra/sinatra) on
-  http://www.rubydoc.info/
+  [RubyDoc](http://www.rubydoc.info/)
 * [CI server](https://travis-ci.org/sinatra/sinatra)

data/README.ru.md

@@ -1,12 +1,49 @@
 # Sinatra
 
+[![Build Status](https://secure.travis-ci.org/sinatra/sinatra.svg)](http://travis-ci.org/sinatra/sinatra)
+
+*Внимание: Этот документ является переводом английской версии и может быть
+устаревшим*
+
+Sinatra — это предметно-ориентированный каркас
+([DSL](https://ru.wikipedia.org/wiki/Предметно-ориентированный_язык))
+для быстрого создания функциональных веб-приложений на Ruby с минимумом усилий:
+
+```ruby
+# myapp.rb
+require 'sinatra'
+
+get '/' do
+  'Hello world!'
+end
+```
+
+Установите gem:
+
+```shell
+gem install sinatra
+```
+
+и запустите приложение с помощью:
+
+```shell
+ruby myapp.rb
+```
+
+Оцените результат: [http://localhost:4567](http://localhost:4567)
+
+Рекомендуется также установить Thin, сделать это можно командой: `gem install
+thin`. Thin — это более производительный и функциональный сервер для
+разработки приложений на Sinatra.
+
 ## Содержание
 
 * [Sinatra](#sinatra)
+    * [Содержание](#Содержание)
     * [Маршруты](#Маршруты)
-        * [Условия](#Условия)
-        * [Возвращаемые значения](#Возвращаемые-значения)
-        * [Собственные детекторы совпадений для маршрутов](#Собственные-детекторы-совпадений-для-маршрутов)
+    * [Условия](#Условия)
+    * [Возвращаемые значения](#Возвращаемые-значения)
+    * [Собственные детекторы совпадений для маршрутов](#Собственные-детекторы-совпадений-для-маршрутов)
     * [Статические файлы](#Статические-файлы)
     * [Представления / Шаблоны](#Представления--Шаблоны)
         * [Буквальные шаблоны](#Буквальные-шаблоны)
@@ -39,14 +76,17 @@
         * [Именованные шаблоны](#Именованные-шаблоны)
         * [Привязка файловых расширений](#Привязка-файловых-расширений)
         * [Добавление собственного движка рендеринга](#Добавление-собственного-движка-рендеринга)
+        * [Использование пользовательской логики для поиска шаблона](#Использование-пользовательской-логики-для-поиска-шаблона)
     * [Фильтры](#Фильтры)
     * [Методы-помощники](#Методы-помощники)
         * [Использование сессий](#Использование-сессий)
+          * [Секретная безопасность сессии](#Секретная-безопасность-сессии)
+          * [Конфигурация сессии](#Конфигурация-сессии)
           * [Выбор вашей собственной "прослойки" сессии](#Выбор-вашей-собственной-прослойки-сессий)
         * [Прерывание](#Прерывание)
         * [Передача](#Передача)
         * [Вызов другого маршрута](#Вызов-другого-маршрута)
-        * [Задание тела, кода и заголовков ответа](#Задание-тела-кода-и-заголовков-ответа)
+        * [Задание тела, статус кода и заголовков ответа](#Задание-тела-статуса-кода-и-заголовков-ответа)
         * [Стриминг ответов](#Стриминг-ответов)
         * [Логирование](#Логирование)
         * [Mime-типы](#mime-типы)
@@ -79,47 +119,13 @@
         * [Область видимости запроса / экземпляра](#Область-видимости-запроса--экземпляра)
         * [Область видимости делегирования](#Область-видимости-делегирования)
     * [Командная строка](#Командная-строка)
-        * [Multi-threading](#multi-threading)
+        * [Многопоточность](#Многопоточность)
     * [Системные требования](#Системные-требования)
     * [На острие](#На-острие)
         * [С помощью Bundler](#С-помощью-bundler)
     * [Версии](#Версии)
     * [Дальнейшее чтение](#Дальнейшее-чтение)
 
-*Внимание: Этот документ является переводом английской версии и может быть
-устаревшим*
-
-Sinatra — это предметно-ориентированный каркас
-([DSL](https://ru.wikipedia.org/wiki/Предметно-ориентированный_язык))
-для быстрого создания функциональных веб-приложений на Ruby с минимумом усилий:
-
-```ruby
-# myapp.rb
-require 'sinatra'
-
-get '/' do
-  'Hello world!'
-end
-```
-
-Установите gem:
-
-```shell
-gem install sinatra
-```
-
-и запустите приложение с помощью:
-
-```shell
-ruby myapp.rb
-```
-
-Оцените результат: [http://localhost:4567](http://localhost:4567)
-
-Рекомендуется также установить Thin, сделать это можно командой: `gem install
-thin`. Thin — это более производительный и функциональный сервер для
-разработки приложений на Sinatra.
-
 ## Маршруты
 
 В Sinatra маршрут — это пара: <HTTP метод> и <шаблон URL>. Каждый маршрут
@@ -151,32 +157,43 @@ options '/' do
 end
 
 link '/' do
-  .. что-то подключить ..
+  # .. что-то подключить ..
 end
 
 unlink '/' do
-  .. что-то отключить ..
+  # .. что-то отключить ..
 end
 ```
 
 Маршруты сверяются с запросом в порядке очередности их записи в файле
 приложения. Первый же совпавший с запросом маршрут и будет вызван.
 
+Маршруты с конечным слэшем отличаются от маршрутов без него:
+
+```ruby
+get '/foo' do
+  # не соответствует "GET /foo/"
+end
+```
+
 Шаблоны маршрутов могут включать в себя именованные параметры, доступные в xэше
 `params`:
 
 ```ruby
 get '/hello/:name' do
   # соответствует "GET /hello/foo" и "GET /hello/bar",
-  # где params['name'] 'foo' или 'bar'
+  # где params['name'] - это 'foo' или 'bar'
   "Hello #{params['name']}!"
 end
 ```
 
-Также можно использовать именованные параметры в качестве переменных блока:
+Также можно получить доступ к именованным параметрам через параметры блока:
 
 ```ruby
 get '/hello/:name' do |n|
+  # соответствует "GET /hello/foo" и "GET /hello/bar",
+  # где params['name'] - это 'foo' или 'bar'
+  # n хранит params['name']
   "Hello #{n}!"
 end
 ```
@@ -215,7 +232,7 @@ end
 Или с параметром блока:
 
 ```ruby
-# Находит "GET /meta/hello/world", "GET /hello/world/1234" и так далее
+# Соответствует "GET /meta/hello/world", "GET /hello/world/1234" и т.д.
 get %r{/hello/([\w]+)} do |c|
   "Hello, #{c}!"
 end
@@ -229,10 +246,33 @@ get '/posts/:format?' do
 end
 ```
 
+Маршруты также могут использовать параметры запроса:
+
+```ruby
+get '/posts' do
+  # соответствует "GET /posts?title=foo&author=bar"
+  title = params['title']
+  author = params['author']
+  # используются переменные title и author; запрос не обязателен для маршрута /posts
+end
+```
+
 Кстати, если вы не отключите защиту от обратного пути в директориях (path
 traversal, см. ниже), путь запроса может быть изменен до начала поиска
 подходящего маршрута.
 
+Вы можете настроить Mustermann опции, используемые для данного маршрута, путём передачи в `:mustermann_opts` хэш:
+
+```ruby
+get '\A/posts\z', :mustermann_opts => { :type => :regexp, :check_anchors => false } do
+  # в точности соответствует /posts, с явной привязкой
+  "If you match an anchored pattern clap your hands!"
+end
+```
+
+Это похоже на [условие](#Условия), но это не так! Эти опции будут объеденины в глобальный `:mustermann_opts` хэш, описанный
+[ниже](#Доступные-настройки).
+
 ### Условия
 
 Маршруты могут включать различные условия совпадений, например, клиентское
@@ -263,6 +303,7 @@ get '/', :provides => ['rss', 'atom', 'xml'] do
   builder :feed
 end
 ```
+`provides` ищет заголовок запроса `Accept`.
 
 Вы можете задать собственные условия:
 
@@ -306,7 +347,7 @@ end
 другие значения.
 
 Вы можете вернуть любой объект, который будет либо корректным Rack ответом,
-объектом Rack body, либо кодом состояния HTTP:
+либо объектом Rack body, либо кодом состояния HTTP:
 
 * массив с тремя переменными: `[код (Fixnum), заголовки (Hash), тело ответа
   (должно отвечать на #each)]`;
@@ -330,8 +371,8 @@ get('/') { Stream.new }
 ```
 
 Вы также можете использовать метод `stream` (описываемый ниже), чтобы
-уменьшить количество дублируемого кода и держать логику стриминга прямо в
-маршруте.
+уменьшить количество шаблонного кода и встраивать поточную логику прямо в
+маршрут.
 
 ### Собственные детекторы совпадений для маршрутов
 
@@ -497,6 +538,12 @@ end
     лэйаутов. По умолчанию: тот же шаблонизатор, что используется и для самого
     шаблона. Пример: <tt>set :rdoc, :layout_engine => :erb</tt>
   </dd>
+
+  <dt>layout_options</dt>
+  <dd>
+    Специальные опции, используемые только для рендеринга лэйаута. Например:
+    <tt>set :rdoc, :layout_options => { :views => 'views/layouts' }</tt>
+  </dd>
 </dl>
 
 По умолчанию считается, что шаблоны находятся в директории `./views`. Чтобы
@@ -519,7 +566,15 @@ get '/' do
 end
 ```
 
-Отобразит шаблон, переданный строкой.
+Отобразит шаблон, переданный строкой. Опционально, можно задать `:path` и
+`:line` для более понятного бэктрейса, в случае, если существует путь к 
+файловой системе и линия, которые ассоциируются с этой строкой:
+
+```ruby
+get '/' do
+  haml '%div.title Hello World', :path => 'examples/file.haml', :line => 3
+end
+```
 
 ### Доступные шаблонизаторы
 
@@ -1117,9 +1172,9 @@ end
 как описано выше, либо он может быть дополнен блоком:
 
 ```ruby
-    erb :post, :layout => false do
-      erb :index
-    end
+erb :post, :layout => false do
+  erb :index
+end
 ```
 
 Эти инструкции в основном эквивалентны `erb :index, :layout => :post`.
@@ -1128,19 +1183,19 @@ end
 создания вложенных раскладок:
 
 ```ruby
-    erb :main_layout, :layout => false do
-      erb :admin_layout do
-        erb :user
-      end
-    end
+erb :main_layout, :layout => false do
+  erb :admin_layout do
+    erb :user
+  end
+end
 ```
 
 Это же самое может быть сделано короче:
 
 ```ruby
-    erb :admin_layout, :layout => :main_layout do
-      erb :user
-    end
+erb :admin_layout, :layout => :main_layout do
+  erb :user
+end
 ```
 
 В настоящее время, следующие интерпретирующие шаблоны методы
@@ -1232,6 +1287,23 @@ 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
+```
+
 ## Фильтры
 
 `before`-фильтры выполняются перед каждым запросом в том же контексте, что и
@@ -1274,7 +1346,7 @@ before '/protected/*' do
 end
 
 after '/create/:slug' do |slug|
-  session['last_slug'] = slug
+  session[:last_slug] = slug
 end
 ```
 
@@ -1292,8 +1364,8 @@ end
 
 ## Методы-помощники
 
-Используйте метод `helpers`, чтобы определить методы-помощники, которые в
-дальнейшем можно будет использовать в обработчиках маршрутов и шаблонах:
+Используйте высокоуровневый метод `helpers`, чтобы определить 
+методы-помощники для использования в обработчиках маршрутов и шаблонах:
 
 ```ruby
 helpers do
@@ -1332,7 +1404,7 @@ helpers FooUtils, BarUtils
 enable :sessions
 
 get '/' do
-  "value = " << session['value'].inspect
+  "value = " << session[:value].inspect
 end
 
 get '/:value' do
@@ -1340,16 +1412,83 @@ get '/:value' do
 end
 ```
 
-Для повышения безопасности данные сессии в куках подписываются секретным
-ключом. Секретный ключ генерируется Sinatra. Тем не менее, так как этот ключ
-будет меняться с каждым запуском приложения, вы, возможно, захотите установить
-ключ вручную, чтобы у всех экземпляров вашего приложения был один и тот же
-ключ:
+### Секретная безопасность сессии
+
+Чтобы повысить безопасность, данные сессии в файле 'cookie' подписываются 
+ключом сессии с использованием `HMAC-SHA1`. Этот ключ сессии должен быть 
+оптимальным криптографическим 'secure random' значением соответствующей 
+длины, которая для `HMAC-SHA1` больше или равна 64 байтам (512 бит, 128 
+шестнадцатеричных символов). Не рекомендуется использовать ключ, длина
+которого менее 32 байт (256 бит, 64 шестнадцатеричных символа). Поэтому 
+**очень важно**, чтобы вы не просто составили значение ключа, а использовали 
+генератор 'secure random' чисел для его создания. Люди очень плохо генерируют 
+случайные значения.
+
+По умолчанию, Sinatra создаёт для вас 'secure random' ключ сессии из 32 байт, 
+но он будет меняться при каждом перезапуске приложения. Если у вас есть
+несколько экземпляров вашего приложения, и вы позволяете чтобы Sinatra 
+генерировала ключ, то каждый экземпляр будет иметь отличный ключ сессии, 
+который, вероятно, не тот, который вы хотите.
+                                      
+Для лучшей безопасности и удобства использования
+[рекомендуется](https://12factor.net/config) генерировать 'secure random' 
+ключ и хранить его в переменной среды на каждом хосте, на котором запущено 
+приложение, чтобы все экземпляры вашего приложения использовали один и тот 
+же ключ. Вы должны периодически менять значение ключа сессии. 
+Вот несколько примеров того, как вы можете создать ключ на 64 байта 
+и установить его:                                   
+
+**Генерация ключа сессии**
+
+```text
+$ ruby -e "require 'securerandom'; puts SecureRandom.hex(64)"
+99ae8af...snip...ec0f262ac
+```
+
+**Генерация ключа сессии (бонусные пункты)**
+
+Используйте [гем 'sysrandom'](https://github.com/cryptosphere/sysrandom) 
+Предпочтительнее использовать системные средства RNG для генерации случайных 
+значений вместо пространства пользователя `OpenSSL`, для которого в данный 
+момент по умолчанию используется MRI Ruby:
+
+```text
+$ gem install sysrandom
+Создание собственных расширений. Это может занять некоторое время... 
+Успешно установлен sysrandom-1.x
+1 gem установлен
+
+$ ruby -e "require 'sysrandom/securerandom'; puts SecureRandom.hex(64)"
+99ae8af...snip...ec0f262ac
+```
+
+**Переменная среды `SESSION_SECRET`**
+
+Задайте переменной среды для Sinatra `SESSION_SECRET` значение, которое вы 
+сгенерировали. Сделайте это значение постоянным при перезагрузке вашего 
+хоста. Поскольку метод для генерации будет различным в разных системах, 
+то код ниже приведён только в качестве примера:
+
+```bash
+# echo "export SESSION_SECRET=99ae8af...snip...ec0f262ac" >> ~/.bashrc
+```
+
+**Конфигурация приложения**
+
+Настройте конфигурацию вашего приложения в безопасном режиме для 
+'secure random' ключа если переменная среды `SESSION_SECRET` не доступна.
+
+В качестве бонусных пунктов здесь тоже используйте 
+[гем 'sysrandom'gem](https://github.com/cryptosphere/sysrandom) :
 
 ```ruby
-set :session_secret, 'super secret'
+require 'securerandom'
+# -или- require 'sysrandom/securerandom'
+set :session_secret, ENV.fetch('SESSION_SECRET') { SecureRandom.hex(64) }
 ```
 
+#### Конфигурация сессии
+
 Если вы хотите больше настроек для сессий, вы можете задать их, передав хеш
 опций в параметр `sessions`:
 
@@ -1385,10 +1524,12 @@ set :session_store, Rack::Session::Pool
 ```
 
 Вы так же можете не вызывать `enable :sessions`, а вместо этого вызывать
-необходимую вам прослойку так же, как вы это обычно делаете. Очень важно
-обратить внимание на то, что когда вы используете этот метод, основной способ
-защиты сессии **не будет включен по умолчанию**. Если вы хотите включить защиту,
-вам нужно добавить следующие строчки:
+необходимую вам прослойку так же, как вы это обычно делаете. 
+
+Очень важно обратить внимание на то, что когда вы используете этот метод, 
+основной способ защиты сессии **не будет включен по умолчанию**. 
+
+Если вы хотите включить защиту, вам нужно добавить следующие строчки:
 
 ```ruby
 use Rack::Session::Pool, :expire_after => 2592000
@@ -1477,8 +1618,8 @@ end
 производительность, перенеся `"bar"` в метод-помощник, используемый и в
 `/foo`, и в `/bar`.
 
-Если вы хотите, чтобы запрос был отправлен в тот же экземпляр приложения, а не
-в его копию, используйте `call!` вместо `call`.
+Если вы хотите, чтобы запрос был отправлен в тот же экземпляр приложения, 
+а не в его копию, используйте `call!` вместо `call`.
 
 Если хотите узнать больше о `call`, смотрите спецификацию Rack.
 
@@ -1564,20 +1705,20 @@ set :server, :thin
 connections = []
 
 get '/subscribe' do
-  # регистрация клиента
+  # регистрация клиента в событиях сервера
   stream(:keep_open) do |out|
-    connections << out }
+    connections << out
     # удаление "мертвых клиентов"
     connections.reject!(&:closed?)
   end
 end
 
-post '/message' do
+post '/:message' do
   connections.each do |out|
     # уведомить клиента о новом сообщении
     out << params['message'] << "\n"
 
-    # указать клиенту на необходимость снова соединиться
+    # указать клиенту на необходимость снова соединиться
     out.close
   end
 
@@ -1586,6 +1727,9 @@ post '/message' do
 end
 ```
 
+Также клиент может закрыть соединение при попытке записи в сокет. В связи с 
+этим рекомендуется проверить `out.closed?` прежде, чем пытаться записать.
+
 ### Логирование
 
 В области видимости запроса метод `logger` предоставляет доступ к экземпляру
@@ -1671,7 +1815,7 @@ redirect to('/bar'), 303
 redirect 'http://www.google.com/', 'wrong place, buddy'
 ```
 
-Вы также можете перенаправить пользователя обратно, на страницу, с которой он
+Вы также можете перенаправить пользователя обратно на страницу, с которой он
 пришел, с помощью `redirect back`:
 
 ```ruby
@@ -1698,12 +1842,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
 ```
 
@@ -1743,7 +1887,7 @@ end
 немедленно отправят ответ клиенту, если текущая версия уже есть в их кэше:
 
 ```ruby
-get '/article/:id' do
+get "/article/:id" do
   @article = Article.find params['id']
   last_modified @article.updated_at
   etag @article.sha1
@@ -1763,8 +1907,8 @@ etag @article.sha1, :weak
 кэширования, попробуйте [rack-cache](https://github.com/rtomayko/rack-cache):
 
 ```ruby
-require 'rack/cache'
-require 'sinatra'
+require "rack/cache"
+require "sinatra"
 
 use Rack::Cache
 
@@ -1820,32 +1964,33 @@ send_file 'foo.png', :type => :jpg
 
 <dl>
   <dt>filename</dt>
-  <dd>имя файла, по умолчанию: реальное имя файла.</dd>
+    <dd>имя файла, по умолчанию: реальное имя файла.</dd>
 
   <dt>last_modified</dt>
-  <dd>значение для заголовка Last-Modified, по умолчанию: mtime (время
-      изменения) файла.</dd>
+    <dd>значение для заголовка Last-Modified, по умолчанию: mtime (время
+        изменения) файла.</dd>
 
   <dt>type</dt>
-  <dd>тип файла, по умолчанию: определяется по расширению файла.</dd>
+    <dd>тип файла, по умолчанию: определяется по расширению файла.</dd>
 
   <dt>disposition</dt>
-  <dd>используется для заголовка Content-Disposition, возможные значения: <tt>nil</tt>
-      (по умолчанию), <tt>:attachment</tt> и <tt>:inline</tt>.</dd>
+    <dd>
+    используется для заголовка Content-Disposition, возможные значения: <tt>nil</tt>
+      (по умолчанию), <tt>:attachment</tt> и <tt>:inline</tt>
+    </dd>
 
   <dt>length</dt>
-  <dd>значения для заголовка Content-Length, по умолчанию: размер файла.</dd>
+    <dd>значения для заголовка Content-Length, по умолчанию: размер файла.</dd>
 
   <dt>status</dt>
-  <dd>Код ответа. Полезно, когда отдается статический файл в качестве страницы с
-      сообщением об ошибке.</dd>
+    <dd>
+    Код ответа. Полезно, когда отсылается статический файл в качестве страницы с
+      сообщением об ошибке. Если поддерживается обработчик Rack, будут использоваться 
+    другие средства, кроме потоковой передачи из процесса Ruby. Если вы используете 
+    этот вспомогательный метод, Sinatra автоматически обрабатывает запросы диапазона.
+    </dd>
 </dl>
 
-Этот метод будет использовать возможности Rack сервера для отправки файлов,
-если они доступны, в противном случае будет напрямую отдавать файл из Ruby
-процесса. Метод `send_file` также обеспечивает автоматическую обработку
-частичных (range) запросов с помощью Sinatra.
-
 ### Доступ к объекту запроса
 
 Объект входящего запроса доступен на уровне обработки запроса (в фильтрах,
@@ -1934,7 +2079,7 @@ Sinatra предлагает метод-помощник `time_for`, котор
 
 ```ruby
 get '/' do
-  pass if Time.now > time_for('Dec 23, 2012')
+  pass if Time.now > time_for('Dec 23, 2016')
   "still time"
 end
 ```
@@ -2007,10 +2152,10 @@ end
 Заметьте, что `find_template` не проверяет, существует ли файл на самом деле,
 а вызывает заданный блок для всех возможных путей. Дело тут не в
 производительности, дело в том, что `render` вызовет `break`, как только файл
-не будет найден. Содержимое и местонахождение шаблонов будет закэшировано,
-если приложение запущено не в режиме разработки (`set :environment,
-:development`). Вы должны помнить об этих нюансах,  если пишите по-настоящему
-"сумасшедший" метод.
+будет найден. Содержимое и местонахождение шаблонов будет закэшировано, если 
+приложение запущено не в режиме разработки (`set :environment, :development`). 
+Вы должны помнить об этих нюансах, если пишите по-настоящему "сумасшедший" 
+метод.
 
 ## Конфигурация
 
@@ -2036,7 +2181,7 @@ configure do
 end
 ```
 
-Будет запущено, когда окружение (APP_ENV переменная) `:production`:
+Будет запущено, когда окружение (`APP_ENV` переменная) `:production`:
 
 ```ruby
 configure :production do
@@ -2090,174 +2235,217 @@ set :protection, :except => :path_traversal
 set :protection, :except => [:path_traversal, :session_hijacking]
 ```
 
+По умолчанию Sinatra будет устанавливать `session based` защиту только если 
+включена опция `:sessions`. См. 'Использование сессий'. Иногда вы захотите 
+настроить сессии "вне" приложения Sinatra, например, в config.ru или с помощью 
+отдельного экземпляра `Rack::Builder`. В этом случае вы также можете настроить 
+`session based` защиту, передав опцию `:session`:
+
+```ruby
+set :protection, :session => true
+```
+
 ### Доступные настройки
 
 <dl>
   <dt>absolute_redirects</dt>
-  <dd>
-    если отключено, то Sinatra будет позволять использование относительных
-    перенаправлений, но при этом перестанет соответствовать RFC 2616 (HTTP
-    1.1), который разрешает только абсолютные перенаправления.
-  </dd>
-  <dd>
-    Включайте эту опцию, если ваше приложение работает за обратным прокси,
-    который настроен не совсем корректно. Обратите внимание, метод <tt>url</tt> все
-    равно будет генерировать абсолютные URL, если вы не передадите <tt>false</tt>
-    вторым аргументом.
-  </dd>
-  <dd>Отключено по умолчанию.</dd>
+    <dd>
+      если отключено, то Sinatra будет позволять использование относительных
+      перенаправлений, но при этом перестанет соответствовать RFC 2616 (HTTP
+      1.1), который разрешает только абсолютные перенаправления.
+    </dd>
+    <dd>
+      включайте эту опцию, если ваше приложение работает за обратным прокси,
+      который настроен не совсем корректно. Обратите внимание, метод <tt>url</tt> все
+      равно будет генерировать абсолютные URL, если вы не передадите <tt>false</tt>
+      вторым аргументом.
+    </dd>
+    <dd>отключено по умолчанию.</dd>
 
   <dt>add_charset</dt>
-  <dd>
-    mime-типы, к которым метод <tt>content_type</tt> будет автоматически добавлять
-    информацию о кодировке. Вам следует добавлять значения к этой опции
-    вместо ее переопределения: <tt>settings.add_charset &lt;&lt; "application/foobar"</tt>
-  </dd>
+    <dd>
+      mime-типы, к которым метод <tt>content_type</tt> будет автоматически добавлять
+      информацию о кодировке. Вам следует добавлять значения к этой опции
+      вместо ее переопределения: <tt>settings.add_charset << "application/foobar"</tt>
+    </dd>
 
   <dt>app_file</dt>
-  <dd>
-    путь к главному файлу приложения, используется для нахождения корневой
-    директории проекта, директорий с шаблонами и статическими файлами,
-    вложенных шаблонов.
-  </dd>
+    <dd>
+      путь к главному файлу приложения, используется для нахождения корневой
+      директории проекта, директорий с шаблонами и статическими файлами,
+      вложенных шаблонов.
+    </dd>
 
   <dt>bind</dt>
-  <dd>
-    используемый IP-адрес (по умолчанию: 0.0.0.0). Используется только
-    встроенным сервером.
-  </dd>
+    <dd>
+      используемый IP-адрес (по умолчанию: <tt>0.0.0.0</tt> <em>или</em>
+      <tt>localhost</tt> если ваша `environment` настроена на разработку). 
+    Используется только встроенным сервером.
+    </dd>
 
   <dt>default_encoding</dt>
-  <dd>кодировка, если неизвестна (по умолчанию: <tt>"utf-8"</tt>).</dd>
+    <dd>кодировка, если неизвестна (по умолчанию: <tt>"utf-8"</tt>).</dd>
 
   <dt>dump_errors</dt>
-  <dd>отображать ошибки в логе.</dd>
+    <dd>отображать ошибки в логе.</dd>
 
   <dt>environment</dt>
-  <dd>
-    текущее окружение, по умолчанию, значение <tt>ENV['APP_ENV']</tt> или
-    <tt>"development"</tt>, если <tt>ENV['APP_ENV']</tt> недоступна.
-  </dd>
+    <dd>
+      текущее окружение, по умолчанию, значение <tt>ENV['APP_ENV']</tt> или
+      <tt>"development"</tt>, если <tt>ENV['APP_ENV']</tt> недоступна.
+    </dd>
 
   <dt>logging</dt>
-  <dd>использовать логер.</dd>
+    <dd>использовать логер.</dd>
 
   <dt>lock</dt>
-  <dd>
-    создает блокировку для каждого запроса, которая гарантирует обработку
-    только одного запроса в текущий момент времени в Ruby процессе.
+    <dd>
+      создает блокировку для каждого запроса, которая гарантирует обработку
+      только одного запроса в текущий момент времени в Ruby процессе.
+    </dd>
+    <dd>
+      включайте, если ваше приложение не потоко-безопасно (thread-safe).
+      Отключено по умолчанию.
   </dd>
-  <dd>
-    Включайте, если ваше приложение не потоко-безопасно (thread-safe).
-    Отключено по умолчанию.</dd>
 
   <dt>method_override</dt>
-  <dd>
-    использовать "магический" параметр <tt>_method</tt>, для поддержки
-    PUT/DELETE форм в браузерах, которые не поддерживают эти методы.
-  </dd>
+    <dd>
+      использовать "магический" параметр <tt>_method</tt>, для поддержки
+      PUT/DELETE форм в браузерах, которые не поддерживают эти методы.
+    </dd>
+
+  <dt>mustermann_opts</dt>
+    <dd>
+    хэш настроек по умолчанию для перехода к Mustermann.new при компиляции 
+    маршрутов маршрутизации.
+    </dd>
 
   <dt>port</dt>
-  <dd>
-    порт, на котором будет работать сервер.
-    Используется только встроенным сервером.
-  </dd>
+    <dd>
+      порт, на котором будет работать сервер. 
+      Используется только встроенным сервером.
+    </dd>
 
   <dt>prefixed_redirects</dt>
-  <dd>
-    добавлять или нет параметр <tt>request.script_name</tt> к редиректам, если не
-    задан абсолютный путь. Таким образом, <tt>redirect '/foo'</tt> будет вести себя
-    как <tt>redirect to('/foo')</tt>. Отключено по умолчанию.
-  </dd>
+    <dd>
+      добавлять или нет параметр <tt>request.script_name</tt> к редиректам, если не
+      задан абсолютный путь. Таким образом, <tt>redirect '/foo'</tt> будет вести себя
+      как <tt>redirect to('/foo')</tt>. Отключено по умолчанию.
+    </dd>
 
   <dt>protection</dt>
-  <dd>включена или нет защита от атак. Смотрите секцию выше.</dd>
+    <dd>включена или нет защита от атак. Смотрите секцию защиты от атак выше.</dd>
 
   <dt>public_dir</dt>
-  <dd>Алиас для <tt>public_folder</tt>.</dd>
+    <dd>алиас для <tt>public_folder</tt>.</dd>
 
   <dt>public_folder</dt>
-  <dd>
-    путь к директории, откуда будут раздаваться статические файлы.
-    Используется, только если включена раздача статических файлов
-    (см. опцию <tt>static</tt> ниже).
-  </dd>
+    <dd>
+      путь к общедоступной директории, откуда будут раздаваться файлы.
+      Используется, только если включена раздача статических файлов
+      (см. опцию <tt>static</tt> ниже). Берётся из настройки <tt>app_file</tt>,
+    если не установлена.
+    </dd>
+
+  <dt>quiet</dt>
+    <dd>
+      отключает журналы, созданные командами запуска и остановки Sinatra. 
+      <tt>false</tt> по умолчанию.
+    </dd>
 
   <dt>reload_templates</dt>
-  <dd>
-    перезагружать или нет шаблоны на каждый запрос. Включено в режиме
-    разработки.
-  </dd>
+    <dd>
+      перезагружать или нет шаблоны на каждый запрос. Включено в режиме
+      разработки.
+    </dd>
 
   <dt>root</dt>
-  <dd>путь к корневой директории проекта.</dd>
+    <dd>
+    путь к корневой директории проекта. Берётся из настройки <tt>app_file</tt>,
+    если не установлен.
+    </dd>
 
   <dt>raise_errors</dt>
-  <dd>
-    выбрасывать исключения (будет останавливать приложение).
-    По умолчанию включено только в окружении <tt>test</tt>.
-  </dd>
+    <dd>
+      выбрасывать исключения (будет останавливать приложение).
+      По умолчанию включено только в окружении <tt>"test"</tt>.
+    </dd>
 
   <dt>run</dt>
-  <dd>
-    если включено, Sinatra будет самостоятельно запускать веб-сервер. Не
-    включайте, если используете rackup или аналогичные средства.
-  </dd>
+    <dd>
+      если включено, Sinatra будет самостоятельно запускать веб-сервер. Не
+      включайте, если используете rackup или аналогичные средства.
+    </dd>
 
   <dt>running</dt>
-  <dd>работает ли сейчас встроенный сервер? Не меняйте эту опцию!</dd>
+    <dd>работает ли сейчас встроенный сервер? Не меняйте эту опцию!</dd>
 
   <dt>server</dt>
-  <dd>
-    сервер или список серверов, которые следует использовать в качестве
-    встроенного сервера. По умолчанию: <tt>['thin', 'mongrel', 'webrick']</tt>, порядок
-    задает приоритет.</dd>
+    <dd>
+      сервер или список серверов, которые следует использовать в качестве
+      встроенного сервера. Порядок задает приоритет, по умолчанию зависит 
+    от реализации Ruby.
+    </dd>
 
   <dt>sessions</dt>
-  <dd>
-    включить сессии на основе кук (cookie) на базе <tt>Rack::Session::Cookie</tt>.
+    <dd>
+      включить сессии на основе кук (cookie) на базе <tt>Rack::Session::Cookie</tt>.
+      Смотрите секцию "Использование сессий" выше.
+    </dd>
+
+  <dt>session_store</dt>
+    <dd>
+      используется Rack "прослойка" сессии. По умолчанию <tt>Rack::Session::Cookie</tt>. 
     Смотрите секцию "Использование сессий" выше.
-  </dd>
+    </dd>
 
   <dt>show_exceptions</dt>
-  <dd>
-    показывать исключения/стек вызовов (stack trace) в браузере. По умолчанию
-    включено только в окружении <tt>development</tt>.
-  </dd>
-  <dd>
-    Может быть установлено в
-    <tt>:after_handler</tt> для запуска специфичной для приложения обработки ошибок,
-    перед показом трассировки стека в браузере.
-  </dd>
+    <dd>
+      показывать исключения/стек вызовов (stack trace) в браузере. По умолчанию
+      включено только в окружении <tt>"development"</tt>.
+    </dd>
+    <dd>
+      может также быть установлено в <tt>:after_handler</tt> для запуска специфичной 
+    для приложения обработки ошибок, перед показом трассировки стека в браузере.
+    </dd>
 
   <dt>static</dt>
-  <dd>должна ли Sinatra осуществлять раздачу статических файлов.</dd>
-  <dd>Отключите, когда используете какой-либо веб-сервер для этой цели.</dd>
-  <dd>Отключение значительно улучшит производительность приложения.</dd>
-  <dd>По умолчанию включено в классических и отключено в модульных приложениях.</dd>
+    <dd>должна ли Sinatra осуществлять раздачу статических файлов.</dd>
+    <dd>Отключите, когда используете какой-либо веб-сервер для этой цели.</dd>
+    <dd>Отключение значительно улучшит производительность приложения.</dd>
+    <dd>По умолчанию включено в классических и отключено в модульных приложениях.</dd>
 
   <dt>static_cache_control</dt>
-  <dd>
-    когда Sinatra отдает статические файлы, используйте эту опцию, чтобы
-    добавить им заголовок <tt>Cache-Control</tt>. Для этого используется
-    метод-помощник <tt>cache_control</tt>. По умолчанию отключено.
-  </dd>
-  <dd>
-    Используйте массив, когда надо задать несколько значений:
-    <tt>set :static_cache_control, [:public, :max_age => 300]</tt>
-  </dd>
+    <dd>
+      когда Sinatra отдает статические файлы, используйте эту опцию, чтобы
+      добавить им заголовок <tt>Cache-Control</tt>. Для этого используется
+      метод-помощник <tt>cache_control</tt>. По умолчанию отключено.
+    </dd>
+    <dd>
+      используйте массив, когда надо задать несколько значений:
+      <tt>set :static_cache_control, [:public, :max_age => 300]</tt>
+    </dd>
 
   <dt>threaded</dt>
-  <dd>
-    если включено, то Thin будет использовать <tt>EventMachine.defer</tt> для
-    обработки запросов.
-  </dd>
+    <dd>
+      если включено, то Thin будет использовать <tt>EventMachine.defer</tt> для
+      обработки запросов.
+    </dd>
 
   <dt>traps</dt>
-  <dd>должна ли Синатра обрабатывать системные сигналы или нет.</tt></dd>
+    <dd>должна ли Sinatra обрабатывать системные сигналы или нет.</tt></dd>
 
   <dt>views</dt>
-  <dd>путь к директории с шаблонами.</dd>
+    <dd>
+    путь к директории с шаблонами. Берётся из настройки <tt>app_file</tt>,
+    если не установлен.
+    </dd>
+
+  <dt>x_cascade</dt>
+    <dd>
+      Установлен ли заголовок X-Cascade если никакие маршруты не совпадают.
+      <tt>true</tt> по умолчанию.
+    </dd>
 </dl>
 
 ## Режим, окружение
@@ -2269,14 +2457,25 @@ set :protection, :except => [:path_traversal, :session_hijacking]
 `not_found` и `error`, чтобы вы могли увидеть стек вызовов. В окружениях
 `"production"` и `"test"` шаблоны по умолчанию кэшируются.
 
-Для запуска приложения в определенном окружении используйте ключ `-e`
+Для запуска приложения в определенном окружении установите переменную 
+окружения `APP_ENV`:
 
-```
-ruby my_app.rb -e [ENVIRONMENT]
+```shell
+APP_ENV=production ruby my_app.rb
 ```
 
 Вы можете использовать предопределенные методы `development?`, `test?` и
-+production?, чтобы определить текущее окружение.
+`production?`, чтобы определить текущее окружение.
+
+```ruby
+get '/' do
+  if settings.development?
+    "development!"
+  else
+    "not development!"
+  end
+end
+```
 
 ## Обработка ошибок
 
@@ -2298,8 +2497,15 @@ end
 ### Error
 
 Обработчик ошибок `error` будет вызван, когда исключение выброшено из блока
-маршрута, либо из фильтра. Объект-исключение доступен как переменная
-`sinatra.error` в Rack:
+маршрута, либо из фильтра. Но заметьте, что в режиме разработки он будет 
+запускаться, только если вы установите опцию "show exceptions" 
+на `: after_handler`:
+
+```ruby
+set :show_exceptions, :after_handler
+```
+
+Объект-исключение доступен как переменная `sinatra.error` в Rack:
 
 ```ruby
 error do
@@ -2350,9 +2556,11 @@ end
 ```
 
 Sinatra устанавливает специальные `not_found` и `error` обработчики, когда
-приложение запущено в режиме разработки (окружение `:development`).
+приложение запущено в режиме разработки (окружение `:development`) чтобы 
+отображать хорошие трассировки стека и дополнительную информацию об отладке 
+в вашем браузере.
 
-## Rack "прослойки"
+## Rack "прослойка"
 
 Sinatra использует [Rack](http://rack.github.io/), минимальный стандартный
 интерфейс для веб-фреймворков на Ruby. Одной из самых интересных для
@@ -2433,16 +2641,18 @@ class MyAppTest < Minitest::Test
 end
 ```
 
+Примечание: если вы используете Sinatra в модульном стиле, замените 
+`Sinatra::Application` в примере выше выше на имя класса вашего приложения.
+
 ## Sinatra::Base — "прослойки", библиотеки и модульные приложения
 
-Описание своего приложения самым простейшим способом (с помощью DSL верхнего
-уровня, классический стиль) отлично работает для крохотных приложений. В таких
-случаях используется конфигурация, рассчитанная на  микро-приложения
-(единственный файл приложения, `./public` и `./views` директории, логирование,
-страница информации об исключении и т.д.). Тем не менее, такой метод имеет
-множество недостатков при создании компонентов, таких как Rack middleware
-("прослоек"), Rails metal, простых библиотек с серверными компонентами,
-расширений Sinatra. И тут на помощь приходит `Sinatra::Base`:
+Описание вашего приложения на верхнем уровне хорошо работает для микроприложений, 
+но имеет значительные недостатки при создании многоразовых компонентов, таких как 
+Rack "прослойка", Rails metal, простые библиотеки с серверным компонентом или 
+даже расширения Sinatra. Верхний уровень предполагает конфигурацию стиля 
+микроприложений (например, одиночный файл приложения, `./public` и `./views`, 
+каталоги, логгирование, страницу подробных сведений об исключениях и т.д.). 
+И тут на помощь приходит `Sinatra::Base`:
 
 ```ruby
 require 'sinatra/base'
@@ -2461,16 +2671,29 @@ end
 приложениям в DSL верхнего уровня. Большинство таких приложений могут быть
 конвертированы в `Sinatra::Base` компоненты с помощью двух модификаций:
 
-* Вы должны подключать `sinatra/base` вместо `sinatra`, иначе все методы,
+* Вы должны подключать `sinatra/base` вместо `sinatra`, иначе все DSL методы,
   предоставляемые Sinatra, будут импортированы в глобальное пространство
   имен.
 * Поместите все маршруты, обработчики ошибок, фильтры и опции в подкласс
   `Sinatra::Base`.
 
 `Sinatra::Base` — это чистый лист. Большинство опций, включая встроенный
-сервер, по умолчанию отключены. Смотрите
-[Опции и конфигурация](http://www.sinatrarb.com/configuration.html)
-для детальной информации об опциях и их поведении.
+сервер, по умолчанию отключены. Смотрите 
+[Опции и конфигурация](http://www.sinatrarb.com/configuration.html) 
+для детальной информации об опциях и их поведении. Если вы хотите, чтобы 
+поведение было более похоже на то, когда вы определяете свое приложение 
+на верхнем уровне (также известно как классический стиль), вы можете 
+подклассифицировать `Sinatra::Application`:
+
+```ruby
+require 'sinatra/base'
+
+class MyApp < Sinatra::Application
+  get '/' do
+    'Hello world!'
+  end
+end
+```
 
 ### Модульные приложения против классических
 
@@ -2486,14 +2709,56 @@ end
 Переходя с одного стиля на другой, примите во внимание следующие изменения в
 настройках:
 
-    Опция               Классический            Модульный
+<table>
+  <tr>
+    <th>Опция</th>
+    <th>Классический</th>
+    <th>Модульный</th>
+    <th>Модульный</th>
+  </tr>
+
+  <tr>
+    <td>app_file</td>
+    <td>файл с приложением</td>
+    <td>файл с подклассом Sinatra::Base</td>
+    <td>файл с подклассом Sinatra::Application</td>
+  </tr>
+
+  <tr>
+    <td>run</td>
+    <td>$0 == app_file</td>
+    <td>false</td>
+    <td>false</td>
+  </tr>
+
+  <tr>
+    <td>logging</td>
+    <td>true</td>
+    <td>false</td>
+    <td>true</td>
+  </tr>
+
+  <tr>
+    <td>method_override</td>
+    <td>true</td>
+    <td>false</td>
+    <td>true</td>
+  </tr>
+
+  <tr>
+    <td>inline_templates</td>
+    <td>true</td>
+    <td>false</td>
+    <td>true</td>
+  </tr>
 
-    app_file            файл с приложением      файл с подклассом Sinatra::Base
-    run                 $0 == app_file          false
-    logging             true                    false
-    method_override     true                    false
-    inline_templates    true                    false
-    static              true                    File.exist?(public_folder)
+  <tr>
+    <td>static</td>
+    <td>true</td>
+    <td>File.exist?(public_folder)</td>
+    <td>true</td>
+  </tr>
+</table>
 
 ### Запуск модульных приложений
 
@@ -2514,7 +2779,7 @@ end
 
 Затем:
 
-```
+```shell
 ruby my_app.rb
 ```
 
@@ -2522,14 +2787,14 @@ ruby my_app.rb
 использовать любой Rack-совместимый сервер приложений.
 
 ```ruby
-# config.ru
+# config.ru (запускается с помощью Rackup)
 require './my_app'
 run MyApp
 ```
 
 Запускаем:
 
-```
+```shell
 rackup -p 4567
 ```
 
@@ -2573,7 +2838,7 @@ run Sinatra::Application
 Не только сама Sinatra может использовать "прослойки" Rack, но и любое Sinatra
 приложение само может быть добавлено к любому Rack endpoint в качестве
 "прослойки". Этим endpoint (конечной точкой) может быть другое Sinatra
-приложение, или приложение, основанное на Rack (Rails/Ramaze/Camping/...):
+приложение, или приложение, основанное на Rack (Rails/Hamami/Roda/...):
 
 ```ruby
 require 'sinatra/base'
@@ -2621,7 +2886,7 @@ my_app.run!
 наследоваться:
 
 ```ruby
-# config.ru
+# config.ru (запускается с помощью Rackup)
 require 'sinatra/base'
 
 controller = Sinatra.new do
@@ -2723,8 +2988,8 @@ end
 
 У вас будет область видимости запроса в:
 
-* get/head/post/put/delete/options блоках;
-* before/after фильтрах;
+* get, head, post, put, delete, options, patch, link и unlink блоках;
+* before и after фильтрах;
 * методах-помощниках;
 * шаблонах/отображениях.
 
@@ -2740,7 +3005,7 @@ end
 
 У вас будет контекст делегирования внутри:
 
-*  привязки верхнего уровня, если вы сделали `require 'sinatra'`;
+*  привязки верхнего уровня, если вы сделали `require "sinatra"`;
 *  объекта, расширенного с помощью `Sinatra::Delegator`.
 
 Посмотрите сами в код: вот
@@ -2751,8 +3016,8 @@ end
 
 Sinatra приложения могут быть запущены напрямую:
 
-```
-ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
+```shell
+ruby myapp.rb [-h] [-x] [-q] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
 ```
 
 Опции включают:
@@ -2763,6 +3028,7 @@ ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
 -o # указание хоста (по умолчанию 0.0.0.0)
 -e # указание окружения, режима (по умолчанию development)
 -s # указание rack сервера/обработчика (по умолчанию thin)
+-q # включить тихий режим для сервера (по умолчанию выключен)
 -x # включить мьютекс-блокировку (по умолчанию выключена)
 ```
 
@@ -2790,6 +3056,7 @@ class App < Sinatra::Base
 end
 
 App.run!
+
 ```
 
 Чтобы запустить сервер, вы должны выполнить следующую команду:
@@ -2798,48 +3065,35 @@ App.run!
 thin --threaded start
 ```
 
+
 [so-answer]: http://stackoverflow.com/questions/6278817/is-sinatra-multi-threaded/6282999#6282999)
 
 ## Системные требования
 
 Следующие версии Ruby официально поддерживаются:
-
 <dl>
-  <dt>Ruby 1.8.7</dt>
-  <dd>1.8.7 полностью поддерживается, тем не менее, если вас ничто не держит на
-    этой версии, рекомендуем обновиться до 1.9.2 или перейти на JRuby или
-    Rubinius. Поддержка 1.8.7 не будет прекращена до выхода Sinatra 2.0 и Ruby
-    2.0, разве что в случае релиза 1.8.8 (что маловероятно). Но даже тогда,
-    возможно, поддержка не будет прекращена. <b>Ruby 1.8.6 больше не
-    поддерживается.</b> Если вы хотите использовать 1.8.6, откатитесь до Sinatra
-    1.2, которая будет получать все исправления ошибок до тех пор, пока не
-    будет выпущена Sinatra 1.4.0.</dd>
-
-  <dt>Ruby 1.9.2</dt>
-  <dd>1.9.2 полностью поддерживается и рекомендована к использованию.
-    Не используйте 1.9.2p0,
-    известно, что эта версия очень нестабильна при использовании Sinatra. Эта
-    версия будет поддерживаться по крайней мере до выхода Ruby 1.9.4/2.0, а
-    поддержка последней версии 1.9 будет осуществляться до тех пор, пока она
-    поддерживается командой разработчиков Ruby.</dd>
-
-  <dt>Ruby 1.9.3</dt>
-  <dd>1.9.3 полностью поддерживается. Заметьте, что переход на 1.9.3 с
-    ранних версий сделает недействительными все сессии.</dd>
+  <dt>Ruby 2.2</dt>
+  <dd>
+    2.2 полностью поддерживается и рекомендуется. В настоящее время нет 
+  планов отказаться от официальной поддержки.
+  </dd>
 
   <dt>Rubinius</dt>
-  <dd>Rubinius официально поддерживается (Rubinius &gt;= 1.2.4), всё, включая все
-  языки шаблонов, работает. Предстоящий релиз 2.0 также поддерживается.</dd>
+  <dd>
+    Rubinius официально поддерживается (Rubinius >= 2.x). Рекомендуется
+  выполнить <tt>gem install puma</tt>.
+  </dd>
 
   <dt>JRuby</dt>
-  <dd>JRuby официально поддерживается (JRuby &gt;= 1.6.5). Нет никаких проблем с
-  использованием альтернативных шаблонов. Тем не менее, если вы выбираете
-  JRuby, то, пожалуйста, посмотрите на JRuby Rack-серверы, так как Thin не
-  поддерживается полностью на JRuby. Поддержка расширений на C в JRuby все
-  еще экспериментальная, что на данный момент затрагивает только RDiscount,
-  Redcarpet и RedCloth.</dd>
+  <dd>
+    Официально поддерживается последний стабильный релиз JRuby. Не 
+  рекомендуется использовать расширений на C в JRuby. Рекомендуется
+  выполнить <tt>gem install trinidad</tt>.
+  </dd>
 </dl>
 
+Версии Ruby старше 2.2.2 больше не поддерживаются в Sinatra 2.0.
+
 Мы также следим за предстоящими к выходу версиями Ruby.
 
 Следующие реализации Ruby не поддерживаются официально, но известно, что на
@@ -2854,16 +3108,17 @@ thin --threaded start
 работает на этой версии, а на поддерживаемой работает — это не наша проблема,
 а их.
 
-Мы также запускаем наши CI-тесты на версии Ruby, находящейся в разработке
-(предстоящей 2.0.0), и на 1.9.4, но мы не можем ничего гарантировать, так как
-они находятся в разработке. Предполагается, что 1.9.4p0 и 2.0.0p0 будут
-поддерживаться.
+Мы также запускаем наши CI-тесты на ruby-head (будущие версии MRI), но мы не 
+можем ничего гарантировать, так как ведётся постоянная разработка. 
+Предполагается, что предстоящие релизы 2.x будут полностью поддерживаться.
 
 Sinatra должна работать на любой операционной системе, в которой есть одна из
 указанных выше версий Ruby.
 
+Если вы запускаете MacRuby, вы должны выполнить `gem install control_tower`.
+
 Пока невозможно запустить Sinatra на Cardinal, SmallRuby, BlueRuby и на любой
-версии Ruby до 1.8.7.
+версии Ruby старше 2.2.
 
 ## На острие
 
@@ -2873,7 +3128,7 @@ Sinatra должна работать на любой операционной
 Мы также время от времени выпускаем предварительные версии, так что вы можете
 делать так:
 
-```
+```shell
 gem install sinatra --pre
 ```
 
@@ -2886,28 +3141,27 @@ gem install sinatra --pre
 
 Сначала установите Bundler, если у вас его еще нет:
 
-```
+```shell
 gem install bundler
 ```
 
 Затем создайте файл `Gemfile` в директории вашего проекта:
 
 ```ruby
-source :rubygems
-gem 'sinatra', :git => "git://github.com/sinatra/sinatra.git"
+source 'https://rubygems.org'
+gem 'sinatra', :github => 'sinatra/sinatra'
 
 # другие зависимости
 gem 'haml'                    # например, если используете haml
-gem 'activerecord', '~> 3.0'  # может быть, вам нужен и ActiveRecord 3.x
 ```
 
 Обратите внимание, вам нужно будет указывать все зависимости вашего приложения
-в этом файле. Однако, непосредственные зависимости Sinatra (Rack и Tilt)
+в `Gemfile`. Однако, непосредственные зависимости Sinatra (Rack и Tilt)
 Bundler автоматически скачает и добавит.
 
 Теперь вы можете запускать свое приложение так:
 
-```
+```shell
 bundle exec ruby myapp.rb
 ```