sinatra 1.4.8 → 2.0.8.1

data/README.ru.md

@@ -1,12 +1,52 @@
 # Sinatra
 
+[![Build Status](https://secure.travis-ci.org/sinatra/sinatra.svg)](https://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)
+
+Имейте ввиду, что изменения в коде не будут видны до тех пор, пока вы не перезапустите
+сервер. Пожалуйста, перезагружайте сервер каждый раз как вносите изменения или добавьте
+в проект [sinatra/reloader](http://www.sinatrarb.com/contrib/reloader).
+
+Рекомендуется также установить Thin сервер  (`gem install thin`), который автоматически
+работает с Sinatra приложениями.
+
 ## Содержание
 
 * [Sinatra](#sinatra)
+    * [Содержание](#Содержание)
     * [Маршруты](#Маршруты)
-        * [Условия](#Условия)
-        * [Возвращаемые значения](#Возвращаемые-значения)
-        * [Собственные детекторы совпадений для маршрутов](#Собственные-детекторы-совпадений-для-маршрутов)
+    * [Условия](#Условия)
+    * [Возвращаемые значения](#Возвращаемые-значения)
+    * [Собственные детекторы совпадений для маршрутов](#Собственные-детекторы-совпадений-для-маршрутов)
     * [Статические файлы](#Статические-файлы)
     * [Представления / Шаблоны](#Представления--Шаблоны)
         * [Буквальные шаблоны](#Буквальные-шаблоны)
@@ -34,19 +74,23 @@
             * [Yajl шаблоны](#yajl-шаблоны)
             * [WLang шаблоны](#wlang-шаблоны)
         * [Доступ к переменным в шаблонах](#Доступ-к-переменным-в-шаблонах)
-        * [Шаблоны с `yield` и вложенные раскладки (layout)](#Шаблоны-с-yield-и-вложенные-раскладки-layout)
+        * [Шаблоны с `yield` и вложенные лэйауты](#Шаблоны-с-yield-и-вложенные-лэйауты)
         * [Включённые шаблоны](#Включённые-шаблоны)
         * [Именованные шаблоны](#Именованные-шаблоны)
         * [Привязка файловых расширений](#Привязка-файловых-расширений)
         * [Добавление собственного движка рендеринга](#Добавление-собственного-движка-рендеринга)
+        * [Использование пользовательской логики для поиска шаблона](#Использование-пользовательской-логики-для-поиска-шаблона)
     * [Фильтры](#Фильтры)
     * [Методы-помощники](#Методы-помощники)
         * [Использование сессий](#Использование-сессий)
+          * [Безопасность сессии](#Безопасность-сессии)
+          * [Конфигурация сессии](#Конфигурация-сессии)
+          * [Выбор вашей собственной "прослойки" сессии](#Выбор-вашей-собственной-прослойки-сессии)
         * [Прерывание](#Прерывание)
         * [Передача](#Передача)
         * [Вызов другого маршрута](#Вызов-другого-маршрута)
-        * [Задание тела, кода и заголовков ответа](#Задание-тела-кода-и-заголовков-ответа)
-        * [Стриминг ответов](#Стриминг-ответов)
+        * [Установка тела, статус кода и заголовков ответа](#Установка-тела-статус-кода-и-заголовков-ответа)
+        * [Потоковые ответы](#Потоковые-ответы)
         * [Логирование](#Логирование)
         * [Mime-типы](#mime-типы)
         * [Генерирование URL](#Генерирование-url)
@@ -56,7 +100,7 @@
         * [Доступ к объекту запроса](#Доступ-к-объекту-запроса)
         * [Вложения](#Вложения)
         * [Работа со временем и датами](#Работа-со-временем-и-датами)
-        * [Поиск шаблонов](#Поиск-шаблонов)
+        * [Поиск файлов шаблонов](#Поиск-файлов-шаблонов)
     * [Конфигурация](#Конфигурация)
         * [Настройка защиты от атак](#Настройка-защиты-от-атак)
         * [Доступные настройки](#Доступные-настройки)
@@ -78,49 +122,13 @@
         * [Область видимости запроса / экземпляра](#Область-видимости-запроса--экземпляра)
         * [Область видимости делегирования](#Область-видимости-делегирования)
     * [Командная строка](#Командная-строка)
-        * [Multi-threading](#multi-threading)
+        * [Многопоточность](#Многопоточность)
     * [Системные требования](#Системные-требования)
-    * [На острие](#На-острие)
-        * [С помощью Bundler](#С-помощью-bundler)
-        * [Вручную](#Вручную)
-        * [Установка глобально](#Установка-глобально)
+    * [Самая свежая версия](#Самая-свежая-версия)
+        * [При помощи 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>. Каждый маршрут
@@ -152,38 +160,49 @@ 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
 ```
 
-Шаблоны маршрутов также могут включать в себя splat (или '*' маску,
-обозначающую любой символ) параметры, доступные в массиве `params['splat']`:
+Шаблоны маршрутов также могут включать в себя splat параметры (или '*' маску,
+обозначающую любой символ), доступные в массиве `params['splat']`:
 
 ```ruby
 get '/say/*/to/*' do
@@ -205,10 +224,10 @@ get '/download/*.*' do |path, ext|
 end
 ```
 
-Регулярные выражения в качестве шаблонов маршрутов:
+Можно также использовать регулярные выражения в качестве шаблонов маршрутов:
 
 ```ruby
-get /\A\/hello\/([\w]+)\z/ do
+get /\/hello\/([\w]+)/ do
   "Hello, #{params['captures'].first}!"
 end
 ```
@@ -216,7 +235,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
@@ -230,14 +249,37 @@ get '/posts/:format?' do
 end
 ```
 
-Кстати, если вы не отключите защиту от обратного пути в директориях (path
-traversal, см. ниже), путь запроса может быть изменен до начала поиска
-подходящего маршрута.
+Маршруты также могут использовать параметры запроса:
+
+```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` хэш, описанный
+[ниже](#Доступные-настройки).
 
 ### Условия
 
-Маршруты могут включать различные условия совпадений, например, клиентское
-приложение (user agent):
+Маршруты могут включать в себя различные условия совпадений, такие как, например,
+строка агента пользователя (user agent):
 
 ```ruby
 get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
@@ -265,7 +307,9 @@ get '/', :provides => ['rss', 'atom', 'xml'] do
 end
 ```
 
-Вы можете задать собственные условия:
+`provides` ищет заголовок запроса `Accept`.
+
+Вы можете с лёгкостью задавать собственные условия:
 
 ```ruby
 set(:probability) { |value| condition { rand <= value } }
@@ -279,10 +323,10 @@ get '/win_a_car' do
 end
 ```
 
-Для условия, которое принимает несколько параметров, используйте звездочку:
+Ипользуйте splat-оператор (`*`) для условий, которые принимают несколько аргументов:
 
 ```ruby
-set(:auth) do |*roles|   # <- обратите внимание на звездочку
+set(:auth) do |*roles|   # <- обратите внимание на звёздочку
   condition do
     unless logged_in? && roles.any? {|role| current_user.in_role? role }
       redirect "/login/", 303
@@ -302,23 +346,22 @@ end
 ### Возвращаемые значения
 
 Возвращаемое значение блока маршрута ограничивается телом ответа, которое
-будет передано HTTP клиенту, или следующей "прослойкой" (middleware) в Rack
-стеке. Чаще всего это строка, как в примерах выше. Но также приемлемы и
+будет передано HTTP клиенту, или, по крайней мере, следующей "прослойке" (middleware)
+в Rack стеке. Чаще всего это строка как в примерах выше. Но также приемлемы и
 другие значения.
 
 Вы можете вернуть любой объект, который будет либо корректным Rack ответом,
-объектом Rack body, либо кодом состояния HTTP:
+либо объектом Rack body, либо кодом состояния HTTP:
 
-* массив с тремя переменными: `[код (Fixnum), заголовки (Hash), тело ответа
+* массив с тремя переменными: `[код (Integer), заголовки (Hash), тело ответа
   (должно отвечать на #each)]`;
-* массив с двумя переменными: `[код (Fixnum), тело ответа (должно отвечать
+* массив с двумя переменными: `[код (Integer), тело ответа (должно отвечать
   на #each)]`;
 * объект, отвечающий на `#each`, который передает только строковые типы
   данных в этот блок;
-* Fixnum, представляющий код состояния HTTP.
+* Integer, представляющий код состояния HTTP.
 
-
-Таким образом, легко можно реализовать, например, поточный пример:
+Таким образом легко можно реализовать, например, потоковую передачу:
 
 ```ruby
 class Stream
@@ -330,14 +373,14 @@ end
 get('/') { Stream.new }
 ```
 
-Вы также можете использовать метод `stream` (описываемый ниже), чтобы
-уменьшить количество дублируемого кода и держать логику стриминга прямо в
-маршруте.
+Вы также можете использовать вспомогательный метод `stream` (описанный ниже)
+для того, чтобы уменьшить количество шаблонного кода и встроить потоковую
+логику прямо в маршрут.
 
 ### Собственные детекторы совпадений для маршрутов
 
 Как показано выше, Sinatra поставляется со встроенной поддержкой строк и
-регулярных выражений в качестве шаблонов URL. Но и это еще не все. Вы можете
+регулярных выражений в качестве шаблонов URL. Но и это ещё не всё. Вы можете
 легко определить свои собственные детекторы совпадений (matchers) для
 маршрутов:
 
@@ -364,8 +407,8 @@ get all_but("/index") do
 end
 ```
 
-Заметьте, что предыдущий пример, возможно, чересчур усложнен, потому что он
-может быть реализован так:
+Обратите внимание на то, что предыдущий пример, возможно, чересчур усложнён, потому что он
+может быть реализован следующим образом:
 
 ```ruby
 get // do
@@ -374,18 +417,18 @@ get // do
 end
 ```
 
-Или с использованием негативного просмотра вперед:
+Или с использованием негативной опережающей проверки (отрицательное look-ahead условие):
 
 ```ruby
-get %r{^(?!/index$)} do
+get %r{(?!/index)} do
   # ...
 end
 ```
 
 ## Статические файлы
 
-Статические файлы отдаются из `./public` директории. Вы можете указать другое
-место, используя опцию `:public_folder`:
+Статические файлы раздаются из `./public` директории. Вы можете указать другое
+месторасположение при помощи опции `:public_folder`:
 
 ```ruby
 set :public_folder, File.dirname(__FILE__) + '/static'
@@ -395,8 +438,8 @@ set :public_folder, File.dirname(__FILE__) + '/static'
 Например, файл `./public/css/style.css` будет доступен как
 `http://example.com/css/style.css`.
 
-Используйте опцию `:static_cache_control` (см. ниже), чтобы добавить заголовок
-`Cache-Control`.
+Используйте опцию `:static_cache_control` (см. ниже) для того, чтобы добавить
+заголовок `Cache-Control`.
 
 ## Представления / Шаблоны
 
@@ -409,7 +452,7 @@ get '/' do
 end
 ```
 
-Отобразит `views/index.erb`.
+Данный код отрендерит файл `views/index.erb`.
 
 Вместо имени шаблона вы так же можете передавать непосредственно само
 содержимое шаблона:
@@ -421,7 +464,7 @@ get '/' do
 end
 ```
 
-Эти методы принимают второй аргумент, хеш с опциями:
+Метод рендеринга шаблона принимает в качестве второго аргумента хэш с опциями:
 
 ```ruby
 get '/' do
@@ -429,10 +472,10 @@ get '/' do
 end
 ```
 
-Отобразит `views/index.erb`, вложенным в `views/post.erb` (по умолчанию:
-`views/layout.erb`, если существует).
+Данный метод отрендерит шаблон `views/index.erb`, который будет вложен в `views/post.erb`
+(по умолчанию: `views/layout.erb`, если файл существует).
 
-Любые опции, не понимаемые Sinatra, будут переданы в шаблонизатор:
+Любые опции, которые Sinatra не распознает, будут переданы в шаблонизатор:
 
 ```ruby
 get '/' do
@@ -440,7 +483,7 @@ get '/' do
 end
 ```
 
-Вы также можете задавать опции для шаблонизаторов в общем:
+Вы также можете глобально задавать опции для шаблонизаторов:
 
 ```ruby
 set :haml, :format => :html5
@@ -450,7 +493,7 @@ get '/' do
 end
 ```
 
-Опции, переданные в метод, переопределяют опции, заданные с помощью `set`.
+Опции, переданные в метод, переопределяют опции, заданные при помощи `set`.
 
 Доступные опции:
 
@@ -458,13 +501,13 @@ end
   <dt>locals</dt>
   <dd>
     Список локальных переменных, передаваемых в документ.
-    Например: <tt>erb "<%= foo %>", :locals => {:foo => "bar"}</tt>
+    Пример: <tt>erb "<%= foo %>", :locals => {:foo => "bar"}</tt>
   </dd>
 
   <dt>default_encoding</dt>
   <dd>
-    Кодировка, которую следует использовать, если не удалось определить
-    оригинальную. По умолчанию: <tt>settings.default_encoding</tt>.
+    Кодировка, которую следует использовать в том случае, если не удалось
+    определить оригинальную. По умолчанию: <tt>settings.default_encoding</tt>.
   </dd>
 
   <dt>views</dt>
@@ -474,14 +517,15 @@ end
 
   <dt>layout</dt>
   <dd>
-    Использовать или нет лэйаут (<tt>true</tt> или <tt>false</tt>). Если же значение Symbol,
-    то указывает, какой шаблон использовать в качестве лэйаута. Например:
-    <tt>erb :index, :layout => !request.xhr?</tt>
+    Определяет необходимость использования лэйаута (<tt>true</tt> или <tt>false</tt>).
+    Если же в качестве значения передан символ, то его значение будет интерпретировано
+    как наименования файла шаблона лэйаута.
+    Пример: <tt>erb :index, :layout => !request.xhr?</tt>
   </dd>
 
   <dt>content_type</dt>
   <dd>
-    Content-Type отображенного шаблона. По умолчанию: задается шаблонизатором.
+    Content-Type отображенного шаблона. По умолчанию: задаётся шаблонизатором.
   </dd>
 
   <dt>scope</dt>
@@ -494,23 +538,30 @@ end
   <dt>layout_engine</dt>
   <dd>
     Шаблонизатор, который следует использовать для отображения лэйаута.
-    Полезная опция для шаблонизаторов, в которых нет никакой поддержки
+    Полезная опция для шаблонизаторов, в которых отсутствует поддержка
     лэйаутов. По умолчанию: тот же шаблонизатор, что используется и для самого
     шаблона. Пример: <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`. Чтобы
-использовать другую директорию с шаблонами:
+По умолчанию в качестве пути для хранения шаблонов принята директория `./views`.
+Чтобы назначить другую директорию с шаблонами необходимо изменить настройки:
 
 ```ruby
 set :views, settings.root + '/templates'
 ```
 
-Важное замечание: вы всегда должны ссылаться на шаблоны с помощью символов
-(Symbol), даже когда они в поддиректории (в этом случае используйте
-`:'subdir/template'`). Вы должны использовать символы, потому что иначе
-шаблонизаторы попросту отображают любые строки, переданные им.
+Важное замечание: вы всегда должны ссылаться на шаблоны при помощи символов
+(Symbol), даже тогда, когда они расположены в поддиректории (в этом случае
+используйте конструкции вида `:'subdir/template'`). Вы должны использовать
+символы в связи с тем, что в ином случае шаблонизаторы попросту отображают
+любые строки, переданные им.
 
 ### Буквальные шаблоны
 
@@ -520,12 +571,22 @@ get '/' do
 end
 ```
 
-Отобразит шаблон, переданный строкой.
+Отобразит шаблон, содержимое которого передано строкой. Опционально можно
+указать дополнительные опции `:path` и `:line` для того, чтобы улучшить бэктрейс.
+Делайте это в том случае, если строка определена в некотором файле, к которому
+можно указать путь и номер строки, где расположена исходная строка:
+
+```ruby
+get '/' do
+  haml '%div.title Hello World', :path => 'examples/file.haml', :line => 3
+end
+```
 
 ### Доступные шаблонизаторы
 
-Некоторые языки шаблонов имеют несколько реализаций. Чтобы указать, какую
-реализацию использовать, вам следует просто подключить нужную библиотеку:
+Некоторые языки шаблонов имеют несколько реализаций. Для того, чтобы указать
+конкретную реализацию, которую вы хотите использовать, вам следует просто
+подключить нужную библиотеку:
 
 ```ruby
 require 'rdiscount' # или require 'bluecloth'
@@ -556,7 +617,7 @@ get('/') { markdown :index }
     <td>Зависимости</td>
     <td>
       <a href="http://www.kuwata-lab.com/erubis/" title="erubis">erubis</a>
-      или erb (включен в Ruby)
+      или erb (включён в Ruby)
     </td>
   </tr>
   <tr>
@@ -588,7 +649,7 @@ get('/') { markdown :index }
   </tr>
 </table>
 
-Блок также используется и для встроенных шаблонов (см. пример).
+Шаблонизатор также принимает блоки для включённых шаблонов ([см. пример](#Включённые-шаблоны)).
 
 #### Nokogiri шаблоны
 
@@ -607,14 +668,14 @@ get('/') { markdown :index }
   </tr>
 </table>
 
-Блок также используется и для встроенных шаблонов (см. пример).
+Шаблонизатор также принимает блоки для включённых шаблонов ([см. пример](#Включённые-шаблоны)).
 
 #### Sass шаблоны
 
 <table>
   <tr>
     <td>Зависимости</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>Расширения файлов</td>
@@ -631,7 +692,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>Зависимости</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>Расширения файлов</td>
@@ -665,7 +726,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>Зависимости</td>
-    <td><a href="http://liquidmarkup.org/" title="liquid">liquid</a></td>
+    <td><a href="https://shopify.github.io/liquid/" title="liquid">liquid</a></td>
   </tr>
   <tr>
     <td>Расширения файлов</td>
@@ -677,8 +738,9 @@ get('/') { markdown :index }
   </tr>
 </table>
 
-Так как в Liquid шаблонах невозможно вызывать методы из Ruby (кроме `yield`), то
-вы почти всегда будете передавать в шаблон локальные переменные.
+В связи с тем, что в Liquid шаблонах невозможно вызывать методы из Ruby
+(за исключением `yield`), вам почти всегда понадобиться передавать в шаблон
+локальные переменные.
 
 #### Markdown шаблоны
 
@@ -689,8 +751,8 @@ get('/') { markdown :index }
       Любая из библиотек:
         <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>
@@ -705,23 +767,23 @@ get('/') { markdown :index }
 </table>
 
 В Markdown невозможно вызывать методы или передавать локальные переменные.
-Следовательно, вам, скорее всего, придется использовать этот шаблон совместно
+По этой причине вам, скорее всего, придётся использовать этот шаблон совместно
 с другим шаблонизатором:
 
 ```ruby
 erb :overview, :locals => { :text => markdown(:introduction) }
 ```
 
-Заметьте, что вы можете вызывать метод `markdown` из других шаблонов:
+Обратите внимание на то, что вы можете вызывать метод `markdown` из других шаблонов:
 
 ```ruby
 %h1 Hello From Haml!
 %p= markdown(:greetings)
 ```
 
-Вы не можете вызывать Ruby из Markdown, соответственно, вы не можете
-использовать лэйауты на Markdown. Тем не менее, есть возможность использовать
-один шаблонизатор для отображения шаблона, а другой для лэйаута с помощью
+Вы не можете вызывать Ruby код код из Markdown, соответственно вы не можете
+использовать лэйауты на Markdown. Тем не менее, существует возможность использовать
+один шаблонизатор для отображения шаблона, а другой для лэйаута при помощи
 опции `:layout_engine`.
 
 #### Textile шаблоны
@@ -742,23 +804,23 @@ erb :overview, :locals => { :text => markdown(:introduction) }
 </table>
 
 В Textile невозможно вызывать методы или передавать локальные переменные.
-Следовательно, вам, скорее всего, придется использовать этот шаблон совместно
-с другим шаблонизатором:
+Следовательно, вам, скорее всего, придётся использовать данный шаблон
+совместно с другим шаблонизатором:
 
 ```ruby
 erb :overview, :locals => { :text => textile(:introduction) }
 ```
 
-Заметьте, что вы можете вызывать метод `textile` из других шаблонов:
+Обратите внимание на то, что вы можете вызывать метод `textile` из других шаблонов:
 
 ```ruby
 %h1 Hello From Haml!
 %p= textile(:greetings)
 ```
 
-Вы не можете вызывать Ruby из Textile, соответственно, вы не можете
-использовать лэйауты на Textile. Тем не менее, есть возможность использовать
-один шаблонизатор для отображения шаблона, а другой для лэйаута с помощью
+Вы не можете вызывать Ruby код код из Textile, соответственно вы не можете
+использовать лэйауты на Textile. Тем не менее, существует возможность использовать
+один шаблонизатор для отображения шаблона, а другой для лэйаута при помощи
 опции `:layout_engine`.
 
 #### RDoc шаблоны
@@ -779,23 +841,23 @@ erb :overview, :locals => { :text => textile(:introduction) }
 </table>
 
 В RDoc невозможно вызывать методы или передавать локальные переменные.
-Следовательно, вам, скорее всего, придется использовать этот шаблон совместно
+Следовательно, вам, скорее всего, придётся использовать этот шаблон совместно
 с другим шаблонизатором:
 
 ```ruby
 erb :overview, :locals => { :text => rdoc(:introduction) }
 ```
 
-Заметьте, что вы можете вызывать метод `rdoc` из других шаблонов:
+Обратите внимание на то, что вы можете вызывать метод `rdoc` из других шаблонов:
 
 ```ruby
 %h1 Hello From Haml!
 %p= rdoc(:greetings)
 ```
 
-Вы не можете вызывать Ruby из RDoc, соответственно, вы не можете использовать
-лэйауты на RDoc. Тем не менее, есть возможность использовать один шаблонизатор
-для отображения шаблона, а другой для лэйаута с помощью опции
+Вы не можете вызывать Ruby код код из RDoc, соответственно вы не можете использовать
+лэйауты на RDoc. Тем не менее, существует возможность использовать один шаблонизатор
+для отображения шаблона, а другой для лэйаута при помощи опции
 `:layout_engine`.
 
 #### AsciiDoc шаблоны
@@ -843,7 +905,7 @@ erb :overview, :locals => { :text => rdoc(:introduction) }
 <table>
   <tr>
     <td>Зависимости</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>Расширения файлов</td>
@@ -855,7 +917,7 @@ erb :overview, :locals => { :text => rdoc(:introduction) }
   </tr>
 </table>
 
-Блок также используется и для встроенных шаблонов (см. пример).
+Шаблонизатор также принимает блоки для включённых шаблонов ([см. пример](#Включённые-шаблоны)).
 
 #### RABL шаблоны
 
@@ -909,23 +971,23 @@ erb :overview, :locals => { :text => rdoc(:introduction) }
 </table>
 
 В Creole невозможно вызывать методы или передавать локальные переменные.
-Следовательно, вам, скорее всего, придется использовать этот шаблон совместно
+Следовательно, вам, скорее всего, придётся использовать данный шаблон совместно
 с другим шаблонизатором:
 
 ```ruby
 erb :overview, :locals => { :text => creole(:introduction) }
 ```
 
-Заметьте, что вы можете вызывать метод `creole` из других шаблонов:
+обратите внимание на то, что вы можете вызывать метод `creole` из других шаблонов:
 
 ```ruby
 %h1 Hello From Haml!
 %p= creole(:greetings)
 ```
 
-Вы не можете вызывать Ruby из Creole, соответственно, вы не можете
-использовать лэйауты на Creole. Тем не менее, есть возможность использовать
-один шаблонизатор для отображения шаблона, а другой для лэйаута с помощью
+Вы не можете вызывать Ruby код из Creole, соответственно вы не можете
+использовать лэйауты на Creole. Тем не менее, существует возможность использовать
+один шаблонизатор для отображения шаблона, а другой для лэйаута при помощи
 опции `:layout_engine`.
 
 #### MediaWiki шаблоны
@@ -946,23 +1008,23 @@ erb :overview, :locals => { :text => creole(:introduction) }
 </table>
 
 В разметке MediaWiki невозможно вызывать методы или передавать локальные переменные.
-Следовательно, вам, скорее всего, придется использовать этот шаблон совместно
+Следовательно, вам, скорее всего, придётся использовать этот шаблон совместно
 с другим шаблонизатором:
 
 ```ruby
 erb :overview, :locals => { :text => mediawiki(:introduction) }
 ```
 
-Заметьте, что вы можете вызывать метод `mediawiki` из других шаблонов:
+Обратите внимание на то, что вы можете вызывать метод `mediawiki` из других шаблонов:
 
 ```ruby
 %h1 Hello From Haml!
 %p= mediawiki(:greetings)
 ```
 
-Вы не можете вызывать Ruby из MediaWiki, соответственно, вы не можете
-использовать лэйауты на MediaWiki. Тем не менее, есть возможность использовать
-один шаблонизатор для отображения шаблона, а другой для лэйаута с помощью
+Вы не можете вызывать Ruby код из MediaWiki, соответственно вы не можете
+использовать лэйауты на MediaWiki. Тем не менее, существует возможность использовать
+один шаблонизатор для отображения шаблона, а другой для лэйаута при помощи
 опции `:layout_engine`.
 
 #### CoffeeScript шаблоны
@@ -974,7 +1036,7 @@ erb :overview, :locals => { :text => mediawiki(:introduction) }
       <a href="https://github.com/josh/ruby-coffee-script" title="Ruby CoffeeScript">
         CoffeeScript
       </a> и
-      <a href="https://github.com/sstephenson/execjs/blob/master/README.md#readme" title="ExecJS">
+      <a href="https://github.com/sstephenson/execjs" title="ExecJS">
         способ запускать JavaScript
       </a>
     </td>
@@ -998,7 +1060,7 @@ erb :overview, :locals => { :text => mediawiki(:introduction) }
       <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">
+      <a href="https://github.com/sstephenson/execjs" title="ExecJS">
         способ запускать JavaScript
       </a>
     </td>
@@ -1013,8 +1075,8 @@ erb :overview, :locals => { :text => mediawiki(:introduction) }
   </tr>
 </table>
 
-Перед тем, как использовать шаблоны стилус, загрузите `stylus` и
-`stylus/tilt`:
+Перед тем, как использовать шаблоны Stylus, необходимо сперва подключить
+`stylus` и `stylus/tilt`:
 
 ```ruby
 require 'sinatra'
@@ -1051,7 +1113,7 @@ end
 </table>
 
 Содержимое шаблона интерпретируется как код на Ruby, а результирующая
-переменная json затем конвертируется с помощью `#to_json`.
+переменная json затем конвертируется при помощи `#to_json`.
 
 ```ruby
 json = { :foo => 'bar' }
@@ -1059,10 +1121,11 @@ json[:baz] = key
 ```
 
 Опции `:callback` и `:variable` используются для "декорирования" итогового
-объекта.
+объекта:
 
 ```ruby
-var resource = {"foo":"bar","baz":"qux"}; present(resource);
+var resource = {"foo":"bar","baz":"qux"};
+present(resource);
 ```
 
 #### WLang шаблоны
@@ -1070,7 +1133,7 @@ var resource = {"foo":"bar","baz":"qux"}; present(resource);
 <table>
   <tr>
     <td>Зависимости</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>Расширения файлов</td>
@@ -1084,7 +1147,7 @@ var resource = {"foo":"bar","baz":"qux"}; present(resource);
 
 Так как в WLang шаблонах невозможно вызывать методы из Ruby напрямую (за
 исключением `yield`), то вы почти всегда будете передавать в шаблон локальные
-переменные.
+переменные. Лэйауты также могут быть описаны при помощи WLang.
 
 ### Доступ к переменным в шаблонах
 
@@ -1099,7 +1162,7 @@ get '/:id' do
 end
 ```
 
-Либо установите их через хеш локальных переменных:
+Вы также можете установить их при помощи хэша локальных переменных:
 
 ```ruby
 get '/:id' do
@@ -1108,46 +1171,44 @@ get '/:id' do
 end
 ```
 
-Это обычный подход, когда шаблоны рендерятся как части других шаблонов.
+Это обычный подход, применяемый тогда, когда шаблоны рендерятся как части других шаблонов.
 
-### Шаблоны с `yield` и вложенные раскладки (layout)
+### Шаблоны с `yield` и вложенные лэйауты
 
-Раскладка (layout) обычно представляет собой шаблон, который исполняет
-`yield`.
-Такой шаблон может быть либо использован с помощью опции `:template`,
-как описано выше, либо он может быть дополнен блоком:
+Лэйаут (layout) обычно представляет собой шаблон, который исполняет
+`yield`. Такой шаблон может быть использован либо при помощи опции `:template`,
+как описано выше, либо при помощи блока:
 
 ```ruby
-    erb :post, :layout => false do
-      erb :index
-    end
+erb :post, :layout => false do
+  erb :index
+end
 ```
 
-Эти инструкции в основном эквивалентны `erb :index, :layout => :post`.
+Эти инструкции по сути эквивалентны `erb :index, :layout => :post`.
 
 Передача блоков интерпретирующим шаблоны методам наиболее полезна для
-создания вложенных раскладок:
+создания вложенных лэйаутов:
 
 ```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
 ```
 
-В настоящее время, следующие интерпретирующие шаблоны методы
-принимают блок:
-`erb`, `haml`, `liquid`, `slim `, `wlang`.
-Общий метод заполнения шаблонов `render` также принимает блок.
+В настоящее время следующие методы шаблонизаторов
+принимают блок: `erb`, `haml`, `liquid`, `slim `, `wlang`. Кроме того,
+общий метод построения шаблонов `render` также принимает блок.
 
 ### Включённые шаблоны
 
@@ -1170,13 +1231,13 @@ __END__
 %div.title Hello world.
 ```
 
-Заметьте: включённые шаблоны, определенные в исходном файле, который подключил
+Обратите внимание: включённые шаблоны, определённые в исходном файле, который подключил
 Sinatra, будут загружены автоматически. Вызовите `enable :inline_templates`
-напрямую, если используете включённые шаблоны в других файлах.
+напрямую в том случае, если используете включённые шаблоны в других файлах.
 
 ### Именованные шаблоны
 
-Шаблоны также могут быть определены при помощи `template` метода:
+Шаблоны также могут быть определены при помощи метода `template`:
 
 ```ruby
 template :layout do
@@ -1193,8 +1254,8 @@ end
 ```
 
 Если шаблон с именем "layout" существует, то он будет использоваться каждый
-раз при рендеринге. Вы можете отключать лэйаут в каждом конкретном случае с
-помощью `:layout => false` или отключить его для всего приложения: `set :haml,
+раз при рендеринге. Вы можете отключать лэйаут в каждом конкретном случае при
+помощи опции `:layout => false` или отключить его для всего приложения: `set :haml,
 :layout => false`:
 
 ```ruby
@@ -1205,9 +1266,9 @@ end
 
 ### Привязка файловых расширений
 
-Чтобы связать расширение файла с движком рендеринга, используйте
-`Tilt.register`. Например, если вы хотите использовать расширение `tt` для
-шаблонов Textile:
+Для того, чтобы связать расширение файла с движком рендеринга, используйте
+`Tilt.register`. Так, например, вызовите следующий код в том случае, если вы
+хотите использовать расширение `tt` для шаблонов Textile:
 
 ```ruby
 Tilt.register :tt, Tilt[:textile]
@@ -1215,7 +1276,7 @@ Tilt.register :tt, Tilt[:textile]
 
 ### Добавление собственного движка рендеринга
 
-Сначала зарегистрируйте свой движок в Tilt, а затем создайте метод, отвечающий
+Сначала зарегистрируйте собственный движок в Tilt, а затем создайте метод, отвечающий
 за рендеринг:
 
 ```ruby
@@ -1230,8 +1291,25 @@ get '/' do
 end
 ```
 
-Отобразит `./views/index.myat`. Чтобы узнать больше о Tilt, смотрите
-https://github.com/rtomayko/tilt
+Данный код отрендерит `./views/index.myat`.
+Подробнее о [Tilt](https://github.com/rtomayko/tilt#readme).
+
+### Использование пользовательской логики для поиска шаблона
+
+Для того, чтобы реализовать собственный механизм поиска шаблона, 
+необходимо написать метод `#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
+```
 
 ## Фильтры
 
@@ -1262,12 +1340,12 @@ after do
 end
 ```
 
-Заметьте: если вы используете метод `body`, а не просто возвращаете строку из
+Обратите внимание: если вы используете метод `body`, а не просто возвращаете строку из
 маршрута, то тело ответа не будет доступно в `after`-фильтрах, так как оно
 будет сгенерировано позднее.
 
-Фильтры могут использовать шаблоны URL и будут интерпретированы, только если
-путь запроса совпадет с этим шаблоном:
+Фильтры также могут использовать шаблоны URL и будут выполнены только в том случае,
+если путь запроса совпадет с указанным шаблоном:
 
 ```ruby
 before '/protected/*' do
@@ -1275,7 +1353,7 @@ before '/protected/*' do
 end
 
 after '/create/:slug' do |slug|
-  session['last_slug'] = slug
+  session[:last_slug] = slug
 end
 ```
 
@@ -1293,8 +1371,9 @@ end
 
 ## Методы-помощники
 
-Используйте метод `helpers`, чтобы определить методы-помощники, которые в
-дальнейшем можно будет использовать в обработчиках маршрутов и шаблонах:
+Используйте высокоуровневый метод `helpers` для того, чтобы определить 
+методы-помощники, которые могут быть использованы в обработчиках маршрутов
+и шаблонах:
 
 ```ruby
 helpers do
@@ -1326,14 +1405,14 @@ helpers FooUtils, BarUtils
 
 ### Использование сессий
 
-Сессия используется, чтобы сохранять состояние между запросами. Если эта опция
-включена, то у вас будет один хеш сессии на одну пользовательскую сессию:
+Сессия используется для того, чтобы сохранять состояние между запросами. Если
+эта опция включена, то у вас будет один хэш сессии на один пользовательский сеанс:
 
 ```ruby
 enable :sessions
 
 get '/' do
-  "value = " << session['value'].inspect
+  "value = " << session[:value].inspect
 end
 
 get '/:value' do
@@ -1341,36 +1420,86 @@ get '/:value' do
 end
 ```
 
-Заметьте, что при использовании `enable :sessions` все данные сохраняются в
-куках (cookies). Это может быть не совсем то, что вы хотите (например,
-сохранение больших объемов данных увеличит ваш трафик). В таком случае вы
-можете использовать альтернативную Rack "прослойку" (middleware), реализующую
-механизм сессий. Для этого *не надо* вызывать `enable :sessions`, вместо этого
-следует подключить ее так же, как и любую другую "прослойку":
+### Безопасность сессии
 
-```ruby
-use Rack::Session::Pool, :expire_after => 2592000
+Для того, чтобы повысить безопасность, данные сессии в файле 'cookie'
+подписываются ключом сессии с использованием `HMAC-SHA1`. Этот ключ сессии
+должен быть оптимальным криптографическим 'secure random' значением соответствующей 
+длины, которая для `HMAC-SHA1` больше или равна 64 байтам (512 бит, 128 
+шестнадцатеричных символов). Не рекомендуется использовать ключ, длина
+которого менее 32 байт (256 бит, 64 шестнадцатеричных символа). Поэтому 
+**очень важно**, чтобы вы не просто составили значение ключа, а использовали 
+безопасный генератор случайных чисел для его создания. Люди очень плохо
+придумывают случайные значения.
 
-get '/' do
-  "value = " << session['value'].inspect
-end
+По умолчанию, Sinatra создаёт для вас безопасный случайный ключ сессии из
+32 байт, однако он будет меняться при каждом перезапуске приложения. Если у
+вас есть несколько экземпляров вашего приложения, и вы доверили Sinatra 
+генерацию ключа, то каждый экземпляр будет иметь отличный ключ сессии, 
+что, вероятно, не совсем то, что вам необходимо.
+                                      
+Для лучшей безопасности и удобства использования
+[рекомендуется](https://12factor.net/config) генерировать случайный безопасный 
+ключ и хранить его в переменной среды на каждом хосте, на котором запущено 
+приложение, чтобы все экземпляры вашего приложения использовали один и тот 
+же ключ. Вы должны периодически менять значение ключа сессии на новое. 
+Вот несколько примеров того, как вы можете создать 64-байтный ключ
+и установить его:                                   
 
-get '/:value' do
-  session['value'] = params['value']
-end
+**Генерация ключа сессии**
+
+```text
+$ ruby -e "require 'securerandom'; puts SecureRandom.hex(64)"
+99ae8af...snip...ec0f262ac
 ```
 
-Для повышения безопасности данные сессии в куках подписываются секретным
-ключом. Секретный ключ генерируется Sinatra. Тем не менее, так как этот ключ
-будет меняться с каждым запуском приложения, вы, возможно, захотите установить
-ключ вручную, чтобы у всех экземпляров вашего приложения был один и тот же
-ключ:
+**Генерация ключа сессии (бонусные пункты)**
+
+Используйте [гем 'sysrandom'](https://github.com/cryptosphere/sysrandom#readme).
+Предпочтительнее использовать системные средства 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.
+Сделайте это значение постоянным при перезагрузке вашего 
+сервера. Поскольку метод для генерации будет различным в разных системах, 
+то код ниже приведён только в качестве примера:
+
+```bash
+# echo "export SESSION_SECRET=99ae8af...snip...ec0f262ac" >> ~/.bashrc
+```
+
+**Конфигурация приложения**
+
+В целях безопасности настройте конфигурацию вашего приложения таким образом,
+чтобы оно генерировало случайный безопасный ключ тогда, когда переменная
+среды `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`:
 
 ```ruby
@@ -1384,10 +1513,46 @@ foo.com, добавьте *.* перед доменом:
 set :sessions, :domain => '.foo.com'
 ```
 
+#### Выбор вашей собственной "прослойки" сессии
+
+Обратите внимание на то, что при использовании `enable :sessions` все данные
+сохраняются в куках (cookies). Это может быть не совсем то, что вы хотите (например,
+сохранение больших объёмов данных увеличит ваш трафик). В таком случае вы
+можете использовать альтернативную Rack "прослойку" (middleware), реализующую
+механизм сессий. Для этого используете один из способов ниже:
+
+```ruby
+enable :sessions
+set :session_store, Rack::Session::Pool
+```
+
+Или установите параметры сессии при помощи хэша опций:
+
+```ruby
+set :sessions, :expire_after => 2592000
+set :session_store, Rack::Session::Pool
+```
+
+Вы также можете **не вызывать** `enable :sessions`, а вместо этого использовать
+необходимую вам Rack прослойку так же, как вы это обычно делаете. 
+
+Очень важно обратить внимание на то, что когда вы используете этот метод, 
+основной способ защиты сессии **не будет включён по умолчанию**. 
+
+Вам также потребуется добавить следующие Rack middleware для этого:
+
+```ruby
+use Rack::Session::Pool, :expire_after => 2592000
+use Rack::Protection::RemoteToken
+use Rack::Protection::SessionHijacking
+```
+
+Смотрите раздел ["Настройка защиты от атак"](#Настройка-защиты-от-атак) для более подробной информации.
+
 ### Прерывание
 
 Чтобы незамедлительно прервать обработку запроса внутри фильтра или маршрута,
-используйте:
+используйте следующую команду:
 
 ```ruby
 halt
@@ -1425,8 +1590,8 @@ halt erb(:error)
 
 ### Передача
 
-Маршрут может передать обработку запроса следующему совпадающему маршруту,
-используя `pass`:
+Маршрут может передать обработку запроса следующему совпадающему маршруту
+используя метод `pass`:
 
 ```ruby
 get '/guess/:who' do
@@ -1439,7 +1604,7 @@ get '/guess/*' do
 end
 ```
 
-Блок маршрута сразу же прерывается, и контроль переходит к следующему
+Блок маршрута сразу же прерывается, а контроль переходит к следующему
 совпадающему маршруту. Если соответствующий маршрут не найден, то ответом на
 запрос будет 404.
 
@@ -1459,23 +1624,23 @@ get '/bar' do
 end
 ```
 
-Заметьте, что в предыдущем примере можно облегчить тестирование и повысить
-производительность, перенеся `"bar"` в метод-помощник, используемый и в
+Обратите внимание на то, что в предыдущем примере можно облегчить тестирование и
+повысить производительность, перенеся `"bar"` в метод-помощник, используемый и в
 `/foo`, и в `/bar`.
 
-Если вы хотите, чтобы запрос был отправлен в тот же экземпляр приложения, а не
-в его копию, используйте `call!` вместо `call`.
+Если вы хотите, чтобы запрос был отправлен в тот же экземпляр приложения, 
+а не в его копию, используйте `call!` вместо `call`.
 
 Если хотите узнать больше о `call`, смотрите спецификацию Rack.
 
-### Задание тела, кода и заголовков ответа
+### Установка тела, статус кода и заголовков ответа
 
 Хорошим тоном является установка кода состояния HTTP и тела ответа в
 возвращаемом значении обработчика маршрута. Тем не менее, в некоторых
 ситуациях вам, возможно, понадобится задать тело ответа в произвольной точке
-потока исполнения. Вы можете сделать это с помощью метода-помощника `body`.
+потока исполнения. Вы можете сделать это при помощи метода-помощника `body`.
 Если вы задействуете метод `body`, то вы можете использовать его и в
-дальнейшем, чтобы получить доступ к телу ответа.
+дальнейшем, чтобы получить доступ к телу ответа:
 
 ```ruby
 get '/foo' do
@@ -1489,7 +1654,7 @@ end
 
 Также можно передать блок в метод `body`, который затем будет вызван
 обработчиком Rack (такой подход может быть использован для реализации
-поточного ответа, см. "Возвращаемые значения").
+потокового ответа, см. ["Возвращаемые значения"](#Возвращаемые-значения)).
 
 Аналогично вы можете установить код ответа и его заголовки:
 
@@ -1498,7 +1663,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
 ```
@@ -1506,12 +1671,12 @@ end
 Как и `body`, методы `headers` и `status`, вызванные без аргументов,
 возвращают свои текущие значения.
 
-### Стриминг ответов
+### Потоковые ответы
 
 Иногда требуется начать отправлять данные клиенту прямо в процессе
 генерирования частей этих данных. В особых случаях требуется постоянно
 отправлять данные до тех пор, пока клиент не закроет соединение. Вы можете
-использовать метод `stream` вместо написания собственных "оберток".
+использовать метод `stream` вместо разработки собственных "обёрток".
 
 ```ruby
 get '/' do
@@ -1525,15 +1690,15 @@ get '/' do
 end
 ```
 
-Что позволяет вам реализовать стриминговые API,
+Это позволяет вам реализовать стриминговые API,
 [Server Sent Events](https://w3c.github.io/eventsource/),
 и может служить основой для [WebSockets](https://en.wikipedia.org/wiki/WebSocket).
-Также такой подход можно использовать для увеличения производительности в случае,
-когда какая-то часть контента зависит от медленного ресурса.
+Также такой подход можно использовать для увеличения производительности в том случае,
+когда какая-то часть контента (а не весь) зависит от медленного ресурса.
 
-Заметьте, что возможности стриминга, особенно количество одновременно
+Обратите внимание на то, что возможности стриминга, особенно количество одновременно
 обслуживаемых запросов, очень сильно зависят от используемого веб-сервера.
-Некоторые серверы могут и вовсе не поддерживать стриминг.  Если сервер не
+Некоторые серверы могут и вовсе не поддерживать стриминг. Если сервер не
 поддерживает стриминг, то все данные будут отправлены за один раз сразу после
 того, как блок, переданный в `stream`, завершится. Стриминг вообще не работает
 при использовании Shotgun.
@@ -1541,7 +1706,7 @@ end
 Если метод используется с параметром `keep_open`, то он не будет вызывать
 `close` у объекта потока, что позволит вам закрыть его позже в любом другом
 месте. Это работает только с событийными серверами, например, с Thin и
-Rainbows. Другие же серверы все равно будут закрывать поток:
+Rainbows. Другие же серверы всё равно будут закрывать поток:
 
 ```ruby
 # long polling
@@ -1550,20 +1715,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
 
@@ -1572,6 +1737,9 @@ post '/message' do
 end
 ```
 
+Также клиент может закрыть соединение при попытке записи в сокет. В связи с 
+этим рекомендуется выполнить проверку `out.closed?` прежде, чем пытаться произвести запись.
+
 ### Логирование
 
 В области видимости запроса метод `logger` предоставляет доступ к экземпляру
@@ -1588,9 +1756,9 @@ end
 логирование выключено, то этот метод вернет пустой (dummy) объект, поэтому вы
 можете смело использовать его в маршрутах и фильтрах.
 
-Заметьте, что логирование включено по умолчанию только для
-`Sinatra::Application`, а если ваше приложение — подкласс `Sinatra::Base`, то
-вы, наверное, захотите включить его вручную:
+Обратите внимание на то, что логирование включено по умолчанию только для
+`Sinatra::Application`. Если ваше приложение является подклассом `Sinatra::Base`, то
+вы, скорее всего, захотите включить его вручную:
 
 ```ruby
 class MyApp < Sinatra::Base
@@ -1601,8 +1769,8 @@ end
 ```
 
 Чтобы избежать использования любой логирующей "прослойки", задайте опции
-`logging` значение `nil`. Тем не менее, не забывайте, что в такой ситуации
-`logger` вернет `nil`. Чаще всего так делают, когда задают свой собственный
+`logging` значение `nil`. При этом не забывайте, что в такой ситуации
+`logger` будет возвращать `nil`. Чаще всего так делают, когда задают свой собственный
 логер. Sinatra будет использовать то, что находится в `env['rack.logger']`.
 
 ### Mime-типы
@@ -1617,7 +1785,7 @@ configure do
 end
 ```
 
-Вы также можете использовать это в `content_type` методе-помощнике:
+Вы также можете использовать это в методе-помощнике `content_type`:
 
 ```ruby
 get '/' do
@@ -1641,7 +1809,7 @@ end
 
 ### Перенаправление (редирект)
 
-Вы можете перенаправить браузер пользователя с помощью метода `redirect`:
+Вы можете перенаправить браузер пользователя при помощи метода `redirect`:
 
 ```ruby
 get '/foo' do
@@ -1657,8 +1825,8 @@ redirect to('/bar'), 303
 redirect 'http://www.google.com/', 'wrong place, buddy'
 ```
 
-Вы также можете перенаправить пользователя обратно, на страницу, с которой он
-пришел, с помощью `redirect back`:
+Вы также можете перенаправить пользователя обратно на страницу, с которой он
+пришёл, при помощи `redirect back`:
 
 ```ruby
 get '/foo' do
@@ -1671,8 +1839,8 @@ get '/bar' do
 end
 ```
 
-Чтобы передать какие-либо параметры вместе с перенаправлением, либо добавьте
-их в строку запроса:
+Для того, чтобы передать какие-либо параметры вместе с перенаправлением,
+добавьте их в строку запроса:
 
 ```ruby
 redirect to('/bar?sum=42')
@@ -1684,12 +1852,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
 ```
 
@@ -1697,7 +1865,7 @@ end
 
 Установка корректных заголовков — основа правильного HTTP кэширования.
 
-Вы можете легко выставить заголовок Cache-Control таким образом:
+Вы можете легко выставить заголовок Cache-Control следующим образом:
 
 ```ruby
 get '/' do
@@ -1723,13 +1891,14 @@ before do
 end
 ```
 
-Чтобы как следует использовать кэширование, вам следует подумать об
-использовании `etag` или `last_modified`. Рекомендуется использовать эти
-методы-помощники *до* выполнения ресурсоемких вычислений, так как они
-немедленно отправят ответ клиенту, если текущая версия уже есть в их кэше:
+Чтобы использовать кэширование правильно, вам стоит подумать о
+применении `etag` или `last_modified`. Рекомендуется использовать эти
+методы-помощники *до* выполнения ресурсоёмких вычислений, так как они
+немедленно отправят ответ клиенту в том случае, если текущая версия
+уже присутствует в их кэше:
 
 ```ruby
-get '/article/:id' do
+get "/article/:id" do
   @article = Article.find params['id']
   last_modified @article.updated_at
   etag @article.sha1
@@ -1744,13 +1913,13 @@ end
 etag @article.sha1, :weak
 ```
 
-Эти методы-помощники не станут ничего кэшировать для вас, но они дадут
-необходимую информацию для вашего кэша. Если вы ищете легкое решение для
-кэширования, попробуйте [rack-cache](https://github.com/rtomayko/rack-cache):
+Эти методы-помощники не станут ничего кэшировать, однако они дадут
+необходимую информацию для вашего кэша. Если вы ищете лёгкое решение для
+кэширования, попробуйте [rack-cache](https://github.com/rtomayko/rack-cache#readme):
 
 ```ruby
-require 'rack/cache'
-require 'sinatra'
+require "rack/cache"
+require "sinatra"
 
 use Rack::Cache
 
@@ -1767,9 +1936,9 @@ end
 В соответствии с RFC 2616 ваше приложение должно вести себя по-разному, когда
 заголовки If-Match или If-None-Match имеют значение `*`, в зависимости от
 того, существует или нет запрашиваемый ресурс. Sinatra предполагает, что
-ресурсы, к которым обращаются с помощью безопасных (GET) и идемпотентных (PUT)
+ресурсы, к которым обращаются при помощи безопасных (GET) и идемпотентных (PUT)
 методов, уже существуют, а остальные ресурсы (к которым обращаются, например,
-с помощью POST) считает новыми. Вы можете изменить данное поведение с помощью
+при помощи POST) считает новыми. Вы можете изменить данное поведение при помощи
 опции `:new_resource`:
 
 ```ruby
@@ -1806,36 +1975,37 @@ 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.
-
 ### Доступ к объекту запроса
 
 Объект входящего запроса доступен на уровне обработки запроса (в фильтрах,
-маршрутах, обработчиках ошибок) с помощью `request` метода:
+маршрутах, обработчиках ошибок) при помощи `request` метода:
 
 ```ruby
 # приложение запущено на http://example.com/example
@@ -1856,22 +2026,22 @@ get '/foo' do
   request.host                # "example.com"
   request.get?                # true (есть аналоги для других методов HTTP)
   request.form_data?          # false
-  request["some_param"]       # значение параметра some_param. Шорткат для хеша params
+  request["some_param"]       # значение параметра some_param. Шорткат для хэша params
   request.referrer            # источник запроса клиента либо '/'
   request.user_agent          # user agent (используется для :agent условия)
-  request.cookies             # хеш, содержащий cookies браузера
+  request.cookies             # хэш, содержащий cookies браузера
   request.xhr?                # является ли запрос ajax запросом?
   request.url                 # "http://example.com/example/foo"
   request.path                # "/example/foo"
   request.ip                  # IP-адрес клиента
   request.secure?             # false (true, если запрос сделан через SSL)
   request.forwarded?          # true (если сервер работает за обратным прокси)
-  request.env                 # "сырой" env хеш, полученный Rack
+  request.env                 # "сырой" env хэш, полученный Rack
 end
 ```
 
 Некоторые опции, такие как `script_name` или `path_info`, доступны для
-изменения:
+модификации:
 
 ```ruby
 before { request.path_info = "/" }
@@ -1893,8 +2063,8 @@ end
 
 ### Вложения
 
-Вы можете использовать метод `attachment`, чтобы сказать браузеру, что ответ
-сервера должен быть сохранен на диск, а не отображен:
+Вы можете использовать метод `attachment`, чтобы сообщить браузеру о том,
+что ответ сервера должен быть сохранён на диск, а не отображён:
 
 ```ruby
 get '/' do
@@ -1916,18 +2086,18 @@ end
 
 Sinatra предлагает метод-помощник `time_for`, который из заданного значения
 создает объект Time. Он также может конвертировать `DateTime`, `Date` и
-подобные классы:
+схожие классы:
 
 ```ruby
 get '/' do
-  pass if Time.now > time_for('Dec 23, 2012')
+  pass if Time.now > time_for('Dec 23, 2016')
   "still time"
 end
 ```
 
 Этот метод используется внутри Sinatra методами `expires`, `last_modified` и
 им подобными. Поэтому вы легко можете изменить и дополнить поведение этих методов,
-переопределив `time_for` в своем приложении:
+переопределив `time_for` в своём приложении:
 
 ```ruby
 helpers do
@@ -1947,7 +2117,7 @@ get '/' do
 end
 ```
 
-### Поиск шаблонов
+### Поиск файлов шаблонов
 
 Для поиска шаблонов и их последующего рендеринга используется метод
 `find_template`:
@@ -1990,18 +2160,17 @@ end
 
 Вы можете легко вынести этот код в расширение и поделиться им с остальными!
 
-Заметьте, что `find_template` не проверяет, существует ли файл на самом деле,
-а вызывает заданный блок для всех возможных путей. Дело тут не в
-производительности, дело в том, что `render` вызовет `break`, как только файл
-не будет найден. Содержимое и местонахождение шаблонов будет закэшировано,
-если приложение запущено не в режиме разработки (`set :environment,
-:development`). Вы должны помнить об этих нюансах,  если пишите по-настоящему
-"сумасшедший" метод.
+Обратите внимание на тот факт, что `find_template` не проверяет, существует ли
+файл на самом деле, а вызывает заданный блок для всех возможных путей. Дело тут не в
+производительности, а в том, что `render` вызовет `break` как только файл
+будет найден. Содержимое и местонахождение шаблонов будет закэшировано в том случае,
+если приложение запущено не в режиме разработки (`set :environment, :development`). 
+Вы должны помнить об этих нюансах, если пишите по-настоящему "сумасшедший" 
+метод.
 
 ## Конфигурация
 
-Этот блок исполняется один раз при старте в любом окружении, режиме
-(environment):
+Этот блок исполняется один раз при старте в любом окружении (environment):
 
 ```ruby
 configure do
@@ -2022,7 +2191,8 @@ configure do
 end
 ```
 
-Будет запущено, когда окружение (RACK_ENV переменная) `:production`:
+Следующий пример будет выполнен только тогда, когда окружение
+(переменная `APP_ENV`) будет задана как `:production`:
 
 ```ruby
 configure :production do
@@ -2030,7 +2200,8 @@ configure :production do
 end
 ```
 
-Будет запущено, когда окружение `:production` или `:test`:
+Следующий код будет выполнен в том случае, когда окружение
+будет задано как `:production` или `:test`:
 
 ```ruby
 configure :production, :test do
@@ -2038,7 +2209,7 @@ configure :production, :test do
 end
 ```
 
-Вы можете получить доступ к этим опциям с помощью `settings`:
+Вы можете получить доступ к этим опциям при помощи метода `settings`:
 
 ```ruby
 configure do
@@ -2055,16 +2226,16 @@ end
 ### Настройка защиты от атак
 
 Sinatra использует
-[Rack::Protection](https://github.com/sinatra/rack-protection#readme) для защиты
+[Rack::Protection](https://github.com/sinatra/sinatra/tree/master/rack-protection#readme) для защиты
 приложения от простых атак. Вы можете легко выключить эту защиту (что сделает
-ваше приложение чрезвычайно уязвимым):
+ваше приложение чрезвычайно уязвимым к большому числу различных уязвимостей):
 
 ```ruby
 disable :protection
 ```
 
-Чтобы пропустить какой-либо уровень защиты, передайте хеш опций в параметр
-`protection`:
+Чтобы отключить какой-либо конкретный уровень защиты, передайте хэш опций
+в параметр `protection`:
 
 ```ruby
 set :protection, :except => :path_traversal
@@ -2076,204 +2247,268 @@ 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` настроена на "development"). 
+    Используется только встроенным сервером.
+    </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['RACK_ENV']</tt> или
-    <tt>"development"</tt>, если <tt>ENV['RACK_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>server_settings</dt>
+    <dd>
+      Если вы используете в качестве сервера WEBrick, например для работы в
+      режиме разработки, то вы можете передать набор опций для <tt>server_settings</tt>,
+      таких как <tt>SSLEnable</tt> или <tt>SSLVerifyClient</tt>. Тем не менее, такие
+      серверы как Puma или Thin не поддерживают эти параметры, поэтому вы можете
+      устанавливать <tt>server_settings</tt> указав его как метод при вызове
+      <tt>configure</tt>.
+    </dd>
 
   <dt>sessions</dt>
-  <dd>
-    включить сессии на основе кук (cookie) на базе <tt>Rack::Session::Cookie</tt>.
-    Смотрите секцию "Использование сессий" выше.
-  </dd>
+    <dd>
+      включить сессии на основе кук (cookie) на базе <tt>Rack::Session::Cookie</tt>.
+      Смотрите раздел "Использование сессий" выше.
+    </dd>
+
+  <dt>session_store</dt>
+    <dd>
+      используемая Rack "прослойка" для сессии. По умолчанию <tt>Rack::Session::Cookie</tt>. 
+      Смотрите раздел "Использование сессий" выше.
+    </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>
 
 ## Режим, окружение
 
-Есть 3 предопределенных режима, окружения: `"development"`, `"production"` и
-`"test"`. Режим может быть задан через переменную окружения `RACK_ENV`.
+Есть 3 предопределённых режима работы приложения (окружения): `"development"`,
+`"production"` и `"test"`. Режим может быть задан через переменную окружения `APP_ENV`.
 Значение по умолчанию — `"development"`. В этом режиме работы все шаблоны
-перезагружаются между запросами. А также задаются специальные обработчики
+перезагружаются между запросами, а также задаются специальные обработчики
 `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?, чтобы определить текущее окружение.
+Вы можете использовать предопределённые методы `development?`, `test?` и
+`production?`, чтобы определить текущее окружение.
+
+```ruby
+get '/' do
+  if settings.development?
+    "development!"
+  else
+    "not development!"
+  end
+end
+```
 
 ## Обработка ошибок
 
-Обработчики ошибок исполняются в том же контексте, что и маршруты, и
+Обработчики ошибок исполняются в том же контексте, что и маршруты и
 `before`-фильтры, а это означает, что всякие прелести вроде `haml`, `erb`,
 `halt` и т.д. доступны и им.
 
 ### Not Found
 
-Когда выброшено исключение `Sinatra::NotFound`, или кодом ответа является 404,
-то будет вызван `not_found` обработчик:
+В случае возникновения исключения `Sinatra::NotFound` или возврата кода ответа 404
+будет вызван обработчик `not_found`:
 
 ```ruby
 not_found do
@@ -2283,9 +2518,16 @@ end
 
 ### Error
 
-Обработчик ошибок `error` будет вызван, когда исключение выброшено из блока
-маршрута, либо из фильтра. Объект-исключение доступен как переменная
-`sinatra.error` в Rack:
+Обработчик ошибок `error` будет вызван тогда, когда исключение выброшено из блока
+маршрута либо из фильтра. Тем не менее, обратите внимание на то, что в режиме разработки
+он будет запускаться только в том случае, если вы установите опцию "show exceptions" 
+на `: after_handler`:
+
+```ruby
+set :show_exceptions, :after_handler
+```
+
+Объект-исключение доступен как переменная `sinatra.error` в Rack:
 
 ```ruby
 error do
@@ -2293,7 +2535,7 @@ error do
 end
 ```
 
-Конкретные ошибки:
+Пользовательские ошибки:
 
 ```ruby
 error MyCustomError do
@@ -2301,7 +2543,7 @@ error MyCustomError do
 end
 ```
 
-Тогда, если это произошло:
+Тогда, если это возникнет:
 
 ```ruby
 get '/' do
@@ -2335,19 +2577,22 @@ error 400..510 do
 end
 ```
 
-Sinatra устанавливает специальные `not_found` и `error` обработчики, когда
-приложение запущено в режиме разработки (окружение `:development`).
+Sinatra устанавливает специальные обработчики `not_found` и `error`, когда
+приложение запущено в режиме разработки (окружение `:development`) чтобы 
+отображать информативные трассировки стека и дополнительную информацию об отладке 
+в вашем браузере.
 
 ## Rack "прослойки"
 
-Sinatra использует [Rack](http://rack.github.io/), минимальный стандартный
+Sinatra использует [Rack](https://rack.github.io/) - минимальный стандартный
 интерфейс для веб-фреймворков на Ruby. Одной из самых интересных для
 разработчиков возможностей Rack является поддержка "прослоек" ("middleware") —
 компонентов, находящихся "между" сервером и вашим приложением, которые
 отслеживают и/или манипулируют HTTP запросами/ответами для предоставления
 различной функциональности.
 
-В Sinatra очень просто использовать такие "прослойки" с помощью метода `use`:
+Sinatra позволяет очень просто создавать пайплайны из подобных Rack "прослоек"
+при помощи метода `use`:
 
 ```ruby
 require 'sinatra'
@@ -2363,7 +2608,7 @@ end
 
 Семантика `use` идентична той, что определена для
 [Rack::Builder](http://www.rubydoc.info/github/rack/rack/master/Rack/Builder) DSL
-(чаще всего используется в rackup файлах). Например, метод `use` принимает как
+(чаще всего используется в rackup файлах). Так, например, метод `use` принимает как
 множественные переменные, так и блоки:
 
 ```ruby
@@ -2375,20 +2620,18 @@ end
 Rack распространяется с различными стандартными "прослойками" для логирования,
 отладки, маршрутизации URL, аутентификации, обработки сессий. Sinatra
 использует многие из этих компонентов автоматически, основываясь на
-конфигурации, чтобы вам не приходилось подключать (`use`) их вручную.
+конфигурации, чтобы вам не приходилось подключать их при помощи `use` вручную.
 
 Вы можете найти полезные прослойки в
 [rack](https://github.com/rack/rack/tree/master/lib/rack),
 [rack-contrib](https://github.com/rack/rack-contrib#readme),
-или в
-[Rack wiki](https://github.com/rack/rack/wiki/List-of-Middleware).
+или в [Rack wiki](https://github.com/rack/rack/wiki/List-of-Middleware).
 
 ## Тестирование
 
-Тесты для Sinatra приложений могут быть написаны с помощью библиотек,
-фреймворков, поддерживающих тестирование Rack.
-[Rack::Test](http://www.rubydoc.info/github/brynary/rack-test/master/frames)
-рекомендован:
+Тесты для Sinatra приложений могут быть написаны при помощи любых библиотек или
+фреймворков, поддерживающих тестирование Rack. Разработчики гема Sinatra рекомендуют
+использовать [Rack::Test](http://www.rubydoc.info/github/brynary/rack-test/master/frames):
 
 ```ruby
 require 'my_sinatra_app'
@@ -2412,23 +2655,25 @@ 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 "You're using Songbird!", last_response.body
   end
 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'
@@ -2443,20 +2688,33 @@ class MyApp < Sinatra::Base
 end
 ```
 
-Методы, доступные `Sinatra::Base` подклассам идентичны тем, что доступны
-приложениям в DSL верхнего уровня. Большинство таких приложений могут быть
-конвертированы в `Sinatra::Base` компоненты с помощью двух модификаций:
+Методы, доступные подклассам `Sinatra::Base` идентичны тем, что доступны
+приложениям при помощи 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
+```
 
 ### Модульные приложения против классических
 
@@ -2472,19 +2730,61 @@ 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>
 
 ### Запуск модульных приложений
 
 Есть два общепринятых способа запускать модульные приложения: запуск напрямую
-с помощью `run!`:
+при помощи `run!`:
 
 ```ruby
 # my_app.rb
@@ -2500,22 +2800,22 @@ end
 
 Затем:
 
-```
+```shell
 ruby my_app.rb
 ```
 
-Или с помощью конфигурационного файла `config.ru`, который позволяет
-использовать любой Rack-совместимый сервер приложений.
+Или при помощи конфигурационного файла `config.ru`, который позволяет
+использовать любой Rack-совместимый сервер приложений:
 
 ```ruby
-# config.ru
+# config.ru (запускается при помощи Rackup)
 require './my_app'
 run MyApp
 ```
 
 Запускаем:
 
-```
+```shell
 rackup -p 4567
 ```
 
@@ -2541,17 +2841,16 @@ run Sinatra::Application
 
 ### Когда использовать config.ru?
 
-Вот несколько причин, по которым вы, возможно, захотите использовать
-`config.ru`:
+Использование файла `config.ru` рекомендовано если:
 
-* вы хотите разворачивать свое приложение на различных Rack-совместимых
+* вы хотите разворачивать своё приложение на различных Rack-совместимых
   серверах (Passenger, Unicorn, Heroku, ...);
 * вы хотите использовать более одного подкласса `Sinatra::Base`;
 * вы хотите использовать Sinatra только в качестве "прослойки" Rack.
 
 **Совсем необязательно переходить на использование `config.ru` лишь потому,
 что вы стали использовать модульный стиль приложения. И необязательно
-использовать модульный стиль, чтобы запускать приложение с помощью
+использовать модульный стиль, чтобы запускать приложение при помощи
 `config.ru`.**
 
 ### Использование Sinatra в качестве "прослойки"
@@ -2559,7 +2858,7 @@ run Sinatra::Application
 Не только сама Sinatra может использовать "прослойки" Rack, но и любое Sinatra
 приложение само может быть добавлено к любому Rack endpoint в качестве
 "прослойки". Этим endpoint (конечной точкой) может быть другое Sinatra
-приложение, или приложение, основанное на Rack (Rails/Ramaze/Camping/...):
+приложение или любое другое приложение, основанное на Rack (Rails/Hamami/Roda/...):
 
 ```ruby
 require 'sinatra/base'
@@ -2595,7 +2894,7 @@ end
 ### Создание приложений "на лету"
 
 Иногда требуется создавать Sinatra приложения "на лету" (например, из другого
-приложения). Это возможно с помощью `Sinatra.new`:
+приложения), не сохраняя их в константу. Это возможно при помощи `Sinatra.new`:
 
 ```ruby
 require 'sinatra/base'
@@ -2607,7 +2906,7 @@ my_app.run!
 наследоваться:
 
 ```ruby
-# config.ru
+# config.ru (запускается при помощи Rackup)
 require 'sinatra/base'
 
 controller = Sinatra.new do
@@ -2627,7 +2926,7 @@ end
 Это особенно полезно для тестирования расширений Sinatra и при использовании
 Sinatra внутри вашей библиотеки.
 
-Благодаря этому, использовать Sinatra как "прослойку" очень просто:
+Это также значительно упрощает использование Sinatra в качестве прослойки:
 
 ```ruby
 require 'sinatra/base'
@@ -2653,7 +2952,7 @@ run RailsProject::Application
 вы не сможете получить доступ к объектам `request` или `session`, так как
 существует только один класс приложения для всех запросов.
 
-Опции, созданные с помощью `set`, являются методами уровня класса:
+Опции, созданные при помощи `set`, являются методами уровня класса:
 
 ```ruby
 class MyApp < Sinatra::Base
@@ -2667,10 +2966,10 @@ class MyApp < Sinatra::Base
 end
 ```
 
-У вас будет область видимости приложения внутри:
+У вас будет привязка к области видимости приложения внутри:
 
 * тела вашего класса приложения;
-* методов, определенных расширениями;
+* методов, определённых расширениями;
 * блока, переданного в `helpers`;
 * блоков, использованных как значения для `set`;
 * блока, переданного в `Sinatra.new`.
@@ -2685,9 +2984,9 @@ end
 
 Для каждого входящего запроса будет создан новый экземпляр вашего приложения,
 и все блоки обработчика будут запущены в этом контексте. В этой области
-видимости вам доступны `request` и `session` объекты, вызовы методов
+видимости вам доступны `request` и `session` объекты, а также вызовы методов
 рендеринга, такие как `erb` или `haml`. Вы можете получить доступ к области
-видимости приложения из контекста запроса, используя метод-помощник
+видимости приложения из контекста запроса используя метод-помощник
 `settings`:
 
 ```ruby
@@ -2707,10 +3006,10 @@ class MyApp < Sinatra::Base
 end
 ```
 
-У вас будет область видимости запроса в:
+У вас будет привязка к области видимости запроса в:
 
-* get/head/post/put/delete/options блоках;
-* before/after фильтрах;
+* get, head, post, put, delete, options, patch, link и unlink блоках;
+* before и after фильтрах;
 * методах-помощниках;
 * шаблонах/отображениях.
 
@@ -2726,8 +3025,8 @@ end
 
 У вас будет контекст делегирования внутри:
 
-*  привязки верхнего уровня, если вы сделали `require 'sinatra'`;
-*  объекта, расширенного с помощью `Sinatra::Delegator`.
+*  привязки верхнего уровня, если вы сделали `require "sinatra"`;
+*  объекта, расширенного при помощи `Sinatra::Delegator`.
 
 Посмотрите сами в код: вот
 [примесь Sinatra::Delegator](https://github.com/sinatra/sinatra/blob/ca06364/lib/sinatra/base.rb#L1609-1633)
@@ -2737,11 +3036,11 @@ 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]
 ```
 
-Опции включают:
+Поддерживаемые опции:
 
 ```
 -h # раздел помощи
@@ -2749,19 +3048,20 @@ 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 # включить мьютекс-блокировку (по умолчанию выключена)
 ```
 
-### Multi-threading
+### Многопоточность
 
-_Данный раздел является перефразированным [ответом пользователя Konstantin][so-answer] на StackOverflow_
+_Данный раздел является перефразированным [ответом пользователя Konstantin](https://stackoverflow.com/a/6282999/5245129) на StackOverflow_
 
 Sinatra не навязывает каких-либо моделей параллелизма, но для этих целей можно
-использовать любой Rack обработчик, например Thin, Puma или WEBrick. Сама
+использовать любой Rack обработчик (сервер), например Thin, Puma или WEBrick. Сама
 по себе Sinatra потокобезопасна, поэтому нет никаких проблем в использовании
 поточной модели параллелизма в Rack обработчике. Это означает, что когда
 запускается сервер, вы должны указать правильный метод вызова для конкретного
-Rack обработчика. Пример ниже показывает, как можно запустить мультитредовый
+Rack обработчика. Пример ниже показывает, как можно запустить мультипоточный
 Thin сервер:
 
 ```ruby
@@ -2776,60 +3076,45 @@ class App < Sinatra::Base
 end
 
 App.run!
+
 ```
 
-Чтобы запустить сервер, вы должны выполнить следующую команду:
+Для запуска сервере выполните следующую команду:
 
 ```shell
 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 не поддерживаются официально, но известно, что на
-них запускается Sinatra:
+Следующие реализации Ruby не поддерживаются официально, однако известно, что
+на них запускается Sinatra:
 
 * старые версии JRuby и Rubinius;
 * Ruby Enterprise Edition;
@@ -2840,102 +3125,66 @@ 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.
 
-## На острие
+## Самая свежая версия
 
-Если вы хотите использовать самый последний код Sinatra, не бойтесь запускать
-свое приложение вместе с кодом из master ветки Sinatra, она весьма стабильна.
+Если вы хотите использовать самый последний релиз Sinatra, не бойтесь запускать
+своё приложение вместе с кодом из master ветки Sinatra, так как она весьма стабильна.
 
-Мы также время от времени выпускаем предварительные версии, так что вы можете
-делать так:
+Мы также время от времени выпускаем предварительные версии, которые вы можете
+установить следующим образом:
 
-```
+```shell
 gem install sinatra --pre
 ```
 
-Чтобы воспользоваться некоторыми самыми последними возможностями.
+таким образом вы сможете воспользоваться некоторыми самыми последними возможностями.
 
-### С помощью Bundler
+### При помощи Bundler
 
-Если вы хотите запускать свое приложение с последней версией Sinatra, то
+Если вы хотите запускать своё приложение с последней версией Sinatra, то
 рекомендуем использовать [Bundler](http://bundler.io).
 
-Сначала установите Bundler, если у вас его еще нет:
+Для начала установите 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
+gem 'haml'                    # в том случае, если используете haml
 ```
 
-Обратите внимание, вам нужно будет указывать все зависимости вашего приложения
-в этом файле. Однако, непосредственные зависимости Sinatra (Rack и Tilt)
-Bundler автоматически скачает и добавит.
+Имейте ввиду, что вам необходимо будет указывать все зависимости вашего приложения
+в `Gemfile`. Необходимые зависимости самой библиотеки Sinatra (Rack и Tilt)
+будут автоматически скачаны и добавлены Bundler.
 
-Теперь вы можете запускать свое приложение так:
+Теперь вы можете запускать своё приложение следующим образом:
 
-```
+```shell
 bundle exec ruby myapp.rb
 ```
 
-### Вручную
-
-Создайте локальный клон репозитория и запускайте свое приложение с
-`sinatra/lib` директорией в `$LOAD_PATH`:
-
-```
-cd myapp
-git clone git://github.com/sinatra/sinatra.git
-ruby -Isinatra/lib myapp.rb
-```
-
-Чтобы обновить исходники Sinatra:
-
-```
-cd myapp/sinatra
-git pull
-```
-
-### Установка глобально
-
-Вы можете самостоятельно собрать gem:
-
-```
-git clone git://github.com/sinatra/sinatra.git
-cd sinatra
-rake sinatra.gemspec
-rake install
-```
-
-Если вы устанавливаете пакеты (gem) от пользователя root, то вашим последним
-шагом должна быть команда
-
-```
-sudo rake install
-```
-
 ## Версии
 
-Sinatra использует [Semantic Versioning](http://semver.org/), SemVer и
+Sinatra использует [Semantic Versioning](https://semver.org/): как SemVer, так и
 SemVerTag.
 
 ## Дальнейшее чтение
@@ -2946,11 +3195,11 @@ SemVerTag.
   баг? Нужна помощь? Написали патч?
 * [Отслеживание проблем/ошибок](https://github.com/sinatra/sinatra/issues)
 * [Twitter](https://twitter.com/sinatra)
-* [Группы рассылки](http://groups.google.com/group/sinatrarb/topics)
-* IRC: [#sinatra](irc://chat.freenode.net/#sinatra) на http://freenode.net
+* [Группы рассылки](https://groups.google.com/forum/#!forum/sinatrarb)
+* IRC: [#sinatra](irc://chat.freenode.net/#sinatra) на [Freenode](https://freenode.net)
 * [Sinatra и Друзья](https://sinatrarb.slack.com) на Slack, а так же
-  [ссылка](https://sinatra-slack.herokuapp.com/) для инвайта.
-* [Sinatra Book](https://github.com/sinatra/sinatra-book/) учебник и сборник рецептов
+  [ссылка для инвайта](https://sinatra-slack.herokuapp.com/).
+* [Sinatra Book](https://github.com/sinatra/sinatra-book) учебник и сборник рецептов
 * [Sinatra Recipes](http://recipes.sinatrarb.com/) сборник рецептов
 * API документация к [последнему релизу](http://www.rubydoc.info/gems/sinatra)
   или [текущему HEAD](http://www.rubydoc.info/github/sinatra/sinatra) на