RubyGems - sinatra - Versions diffs - 2.0.1 → 2.0.2 - Mend

sinatra 2.0.1 → 2.0.2

Potentially problematic release.

This version of sinatra might be problematic. Click here for more details.

Files changed (17) hide show

checksums.yaml +5 -5
data/CHANGELOG.md +65 -43
data/Gemfile +1 -0
data/README.de.md +2 -2
data/README.es.md +2 -2
data/README.fr.md +2 -2
data/README.ja.md +15 -16
data/README.ko.md +2 -2
data/README.md +1 -1
data/README.pt-br.md +2 -2
data/README.ru.md +381 -364
data/README.zh.md +2 -2
data/VERSION +1 -1
data/lib/sinatra/base.rb +7 -6
data/lib/sinatra/indifferent_hash.rb +5 -0
data/lib/sinatra/version.rb +1 -1
metadata +5 -5

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a481c0ba22e73031a7669f68358463db3b92ea47
-  data.tar.gz: 9ad051aed2a9b41ffc3c92bcec42aa0e8d99a7b8
+SHA256:
+  metadata.gz: c6c73742bb14264358d852a59585930faced4fd019996e0674cdd21d92af01ee
+  data.tar.gz: 4c0ecbfcae07c5fdb8f4e704ca6e6a5ad49bb28e329a59c4dc60e2312673927f
 SHA512:
-  metadata.gz: 15a8af507cdc873476fbbfd81d502b39c2f4467c08c7cc6c2b7dde29f7b5ff9dbe3ac7bc9259577c15153a00952e5477fede62546d8db2791b1615edc2a12598
-  data.tar.gz: ea93478022eb8bedde7b3dfc66dc7077c6264022a3da196cc6b9ca927b91c5700c4f1f24f1b03f3e5fe74723897d59e93e25f6fa0f54ecd28d6a6299c0a977a0
+  metadata.gz: 82b602487159d2c84a74442b7220d63130113f95a73f762ee6103f7fa569eb79e95a0e77e496ca12700a751e4ce13b6fe3d6daa6ce82f1a509073d3ae0152259
+  data.tar.gz: 0cc9adf3922c8d471c1176667299debc529129194b68dba70f3041c73d339ee18344a479a0d6d9a239918d3a0dc3d5688b55c749a00900b3b8bb0e0081f0deb3

data/CHANGELOG.md CHANGED

@@ -1,86 +1,108 @@
+## 2.0.2 / 2018-06-05
+* Escape invalid query parameters [#1432](https://github.com/sinatra/sinatra/issues/1432) by Kunpei Sakai
+  * The patch fixes [CVE-2018-11627](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2018-11627).
+* Fix undefined method error for `Sinatra::RequiredParams` with hash key [#1431](https://github.com/sinatra/sinatra/issues/1431) by Arpit Chauhan
+* Add xml content-types to valid html_types for Rack::Protection [#1413](https://github.com/sinatra/sinatra/issues/1413) by Reenan Arbitrario
+* Encode route parameters using :default_encoding setting [#1412](https://github.com/sinatra/sinatra/issues/1412) by Brian m. Carlson
+* Fix unpredictable behaviour from Sinatra::ConfigFile [#1244](https://github.com/sinatra/sinatra/issues/1244) by John Hope
+* Add Sinatra::IndifferentHash#slice [#1405](https://github.com/sinatra/sinatra/issues/1405) by Shota Iguchi
+* Remove status code 205 from drop body response [#1398](https://github.com/sinatra/sinatra/issues/1398) by Shota Iguchi
+* Ignore empty captures from params [#1390](https://github.com/sinatra/sinatra/issues/1390) by Shota Iguchi
+* Improve development support and documentation and source code by Zp Yuan, Andreas Finger, Olle Jonsson, Shota Iguchi, Nikita Bulai and Joshua O'Brien
 ## 2.0.1 / 2018-02-17
-* Repair nested namespaces, by avoiding prefix duplication #1322. Fixes #1310 by Kunpei Sakai
+* Repair nested namespaces, by avoiding prefix duplication [#1322](https://github.com/sinatra/sinatra/issues/1322). Fixes [#1310](https://github.com/sinatra/sinatra/issues/1310) by Kunpei Sakai
-* Add pattern matches to values for Mustermann::Concat #1333. Fixes #1332 by Dawa Ometto
+* Add pattern matches to values for Mustermann::Concat [#1333](https://github.com/sinatra/sinatra/issues/1333). Fixes [#1332](https://github.com/sinatra/sinatra/issues/1332) by Dawa Ometto
-* Ship the VERSION file with the gem, to allow local unpacking #1338 by Olle Jonsson
+* Ship the VERSION file with the gem, to allow local unpacking [#1338](https://github.com/sinatra/sinatra/issues/1338) by Olle Jonsson
-* Fix issue with custom error handler on bad request #1351. Fixes #1350 by Jordan Owens
+* Fix issue with custom error handler on bad request [#1351](https://github.com/sinatra/sinatra/issues/1351). Fixes [#1350](https://github.com/sinatra/sinatra/issues/1350) by Jordan Owens
-* Override Rack::ShowExceptions#pretty to set custom template #1377. Fixes #1376 by Jordan Owens
+* Override Rack::ShowExceptions#pretty to set custom template [#1377](https://github.com/sinatra/sinatra/issues/1377). Fixes [#1376](https://github.com/sinatra/sinatra/issues/1376) by Jordan Owens
-* Enhanced path validation in Windows #1379 by Orange Tsai
+* Enhanced path validation in Windows [#1379](https://github.com/sinatra/sinatra/issues/1379) by Orange Tsai from DEVCORE
+  * The patch fixes [CVE-2018-7212](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2018-7212)
 * Improve development support and documentation by Faheel Ahmad, Shota Iguchi, Olle Jonsson, Manabu Niseki, John Hope, Horacio, Ice-Storm, GraniteRock, Raman Skaskevich, Carlos Azuaje, 284km, Dan Rice and Zachary Scott
 ## 2.0.0 / 2017-04-10
- * Use Mustermann for patterns #1086 by Konstantin Haase
+ * Use Mustermann for patterns [#1086](https://github.com/sinatra/sinatra/issues/1086) by Konstantin Haase
- * Server now provides `-q` flag for quiet mode, which disables start/stop messages #1153 by Vasiliy.
+ * Server now provides `-q` flag for quiet mode, which disables start/stop messages [#1153](https://github.com/sinatra/sinatra/issues/1153) by Vasiliy.
- * Session middleware can now be specified with `:session_store` setting #1161 by Jordan Owens.
+ * Session middleware can now be specified with `:session_store` setting [#1161](https://github.com/sinatra/sinatra/issues/1161) by Jordan Owens.
- * `APP_ENV` is now preferred and recommended over `RACK_ENV` for setting environment #984 by Damien Mathieu.
+ * `APP_ENV` is now preferred and recommended over `RACK_ENV` for setting environment [#984](https://github.com/sinatra/sinatra/issues/984) by Damien Mathieu.
- * Add Reel support #793 by Patricio Mac Adden.
+ * Add Reel support [#793](https://github.com/sinatra/sinatra/issues/793) by Patricio Mac Adden.
- * Make route params available during error handling #895 by Jeremy Evans.
+ * Make route params available during error handling [#895](https://github.com/sinatra/sinatra/issues/895) by Jeremy Evans.
- * Unify `not_found` and `error` 404 behavior #896 by Jeremy Evans.
+ * Unify `not_found` and `error` 404 behavior [#896](https://github.com/sinatra/sinatra/issues/896) by Jeremy Evans.
- * Enable Ruby 2.3 `frozen_string_literal` feature #1076 by Vladimir Kochnev.
+ * Enable Ruby 2.3 `frozen_string_literal` feature [#1076](https://github.com/sinatra/sinatra/issues/1076) by Vladimir Kochnev.
  * Add Sinatra::ShowExceptions::TEMPLATE and patched Rack::ShowExceptions to prefer Sinatra template by Zachary Scott.
- * Sinatra::Runner is used internally for integration tests #840 by Nick Sutterer.
+ * Sinatra::Runner is used internally for integration tests [#840](https://github.com/sinatra/sinatra/issues/840) by Nick Sutterer.
- * Fix case-sensitivity issue in `uri` method #889 by rennex.
+ * Fix case-sensitivity issue in `uri` method [#889](https://github.com/sinatra/sinatra/issues/889) by rennex.
- * Use `Rack::Utils.status_code` to allow `status` helper to use symbol as well as numeric codes #968 by Tobias H. Michaelsen.
+ * Use `Rack::Utils.status_code` to allow `status` helper to use symbol as well as numeric codes [#968](https://github.com/sinatra/sinatra/issues/968) by Tobias H. Michaelsen.
- * Improved error handling for invalid params through Rack #1070 by Jordan Owens.
+ * Improved error handling for invalid params through Rack [#1070](https://github.com/sinatra/sinatra/issues/1070) by Jordan Owens.
- * Ensure template is cached only once #1021 by Patrik Rak.
+ * Ensure template is cached only once [#1021](https://github.com/sinatra/sinatra/issues/1021) by Patrik Rak.
- * Rack middleware is initialized at server runtime rather than after receiving first request #1205 by Itamar Turner-Trauring.
+ * Rack middleware is initialized at server runtime rather than after receiving first request [#1205](https://github.com/sinatra/sinatra/issues/1205) by Itamar Turner-Trauring.
- * Improve Session Secret documentation to encourage better security practices #1218 by Glenn Rempe
+ * Improve Session Secret documentation to encourage better security practices [#1218](https://github.com/sinatra/sinatra/issues/1218) by Glenn Rempe
- * Exposed global and per-route options for Mustermann route parsing #1233 by Mike Pastore
+ * Exposed global and per-route options for Mustermann route parsing [#1233](https://github.com/sinatra/sinatra/issues/1233) by Mike Pastore
- * Use same `session_secret` for classic and modular apps in development #1245 by Marcus Stollsteimer
+ * Use same `session_secret` for classic and modular apps in development [#1245](https://github.com/sinatra/sinatra/issues/1245) by Marcus Stollsteimer
- * Make authenticity token length a fixed value of 32 #1181 by Jordan Owens
+ * Make authenticity token length a fixed value of 32 [#1181](https://github.com/sinatra/sinatra/issues/1181) by Jordan Owens
- * Modernize Rack::Protection::ContentSecurityPolicy with CSP Level 2 and 3 Directives #1202 by Glenn Rempe
+ * Modernize Rack::Protection::ContentSecurityPolicy with CSP Level 2 and 3 Directives [#1202](https://github.com/sinatra/sinatra/issues/1202) by Glenn Rempe
- * Adds preload option to Rack:Protection:StrictTransport #1209 by Ed Robinson
+ * Adds preload option to Rack:Protection:StrictTransport [#1209](https://github.com/sinatra/sinatra/issues/1209) by Ed Robinson
- * Improve BadRequest logic. Raise and handle exceptions if status is 400 #1212 by Mike Pastore
+ * Improve BadRequest logic. Raise and handle exceptions if status is 400 [#1212](https://github.com/sinatra/sinatra/issues/1212) by Mike Pastore
- * Make Rack::Test a development dependency #1232 by Mike Pastore
+ * Make Rack::Test a development dependency [#1232](https://github.com/sinatra/sinatra/issues/1232) by Mike Pastore
- * Capture exception messages of raised NotFound and BadRequest #1210 by Mike Pastore
+ * Capture exception messages of raised NotFound and BadRequest [#1210](https://github.com/sinatra/sinatra/issues/1210) by Mike Pastore
- * Add explicit set method to contrib/cookies to override cookie settings #1240 by Andrew Allen
+ * Add explicit set method to contrib/cookies to override cookie settings [#1240](https://github.com/sinatra/sinatra/issues/1240) by Andrew Allen
- * Avoid executing filters even if prefix matches with other namespace #1253 by namusyaka
+ * Avoid executing filters even if prefix matches with other namespace [#1253](https://github.com/sinatra/sinatra/issues/1253) by namusyaka
- * Make `#has_key?` also indifferent in access, can accept String or Symbol #1262 by Stephen Paul Weber
+ * Make `#has_key?` also indifferent in access, can accept String or Symbol [#1262](https://github.com/sinatra/sinatra/issues/1262) by Stephen Paul Weber
- * Add `allow_if` option to bypass json csrf protection #1265 by Jordan Owens
+ * Add `allow_if` option to bypass json csrf protection [#1265](https://github.com/sinatra/sinatra/issues/1265) by Jordan Owens
- * rack-protection: Bundle StrictTransport, CookieTossing, and CSP #1267 by Mike Pastore
+ * rack-protection: Bundle StrictTransport, CookieTossing, and CSP [#1267](https://github.com/sinatra/sinatra/issues/1267) by Mike Pastore
- * Add `:strict_paths` option for managing trailing slashes #1273 by namusyaka
+ * Add `:strict_paths` option for managing trailing slashes [#1273](https://github.com/sinatra/sinatra/issues/1273) by namusyaka
- * Add full IndifferentHash implementation to params #1279 by Mike Pastore
+ * Add full IndifferentHash implementation to params [#1279](https://github.com/sinatra/sinatra/issues/1279) by Mike Pastore
 ## 1.4.8 / 2017-01-30
- * Fix the deprecation warning from Ruby about Fixnum. #1235 by Akira Matsuda
+ * Fix the deprecation warning from Ruby about Fixnum. [#1235](https://github.com/sinatra/sinatra/issues/1235) by Akira Matsuda
 ## 1.4.7 / 2016-01-24
@@ -88,14 +110,14 @@
  * Correctly handle encoded colons in routes. (Jeremy Evans)
- * Rename CHANGES to CHANGELOG.md and update Rakefile. #1043 (Eliza Sorensen)
+ * Rename CHANGES to CHANGELOG.md and update Rakefile. [#1043](https://github.com/sinatra/sinatra/issues/1043) (Eliza Sorensen)
- * Improve documentation. #941, #1069, #1075, #1025, #1052 (Many great folks)
+ * Improve documentation. [#941](https://github.com/sinatra/sinatra/issues/941), [#1069](https://github.com/sinatra/sinatra/issues/1069), [#1075](https://github.com/sinatra/sinatra/issues/1075), [#1025](https://github.com/sinatra/sinatra/issues/1025), [#1052](https://github.com/sinatra/sinatra/issues/1052) (Many great folks)
  * Introduce `Sinatra::Ext` to workaround Rack 1.6 bug to fix Ruby 1.8.7
-   support. #1080 (Zachary Scott)
+   support. [#1080](https://github.com/sinatra/sinatra/issues/1080) (Zachary Scott)
- * Add CONTRIBUTING guide. #987 (Katrina Owen)
+ * Add CONTRIBUTING guide. [#987](https://github.com/sinatra/sinatra/issues/987) (Katrina Owen)
 ## 1.4.6 / 2015-03-23
@@ -632,7 +654,7 @@ Backported from 1.3.0:
    same middleware chain. This caused issues if any non-sinatra routing
    happened in-between two of those instances, or running a request twice
    against an application (described in the README). The caching was reverted.
-   See GH#239 and GH#256 for more infos. (Konstantin Haase)
+   See GH[#239](https://github.com/sinatra/sinatra/issues/239) and GH[#256](https://github.com/sinatra/sinatra/issues/256) for more infos. (Konstantin Haase)
  * Fixes issues where the top level DSL was interfering with method_missing
    proxies. This issue surfaced when Rails 3 was used with older Sass versions
@@ -1338,7 +1360,7 @@ the 1.0 release:
  * BUG: raising Sinatra::NotFound resulted in a 500 response
    code instead of 404.
- * BUG: use_in_file_templates! fails with CR/LF (#45)
+ * BUG: use_in_file_templates! fails with CR/LF [#45]
  * BUG: Sinatra detects the app file and root path when run under
    thin/passenger.

data/Gemfile CHANGED

@@ -34,6 +34,7 @@ if RUBY_ENGINE == "ruby"
   gem 'bluecloth'
   gem 'rdiscount'
   gem 'RedCloth'
+  gem "activesupport", "~> 5.1.6"
   gem 'puma'
   gem 'yajl-ruby'
   gem 'nokogiri'

data/README.de.md CHANGED

@@ -728,7 +728,7 @@ Nimmt ebenso einen Block für Inline-Templates entgegen (siehe Beispiel).
 <table>
   <tr>
     <td>Abhängigkeit</td>
-    <td><a href="http://liquidmarkup.org/">liquid</a></td>
+    <td><a href="https://shopify.github.io/liquid/">liquid</a></td>
   </tr>
   <tr>
     <td>Dateierweiterung</td>
@@ -752,7 +752,7 @@ denen man Variablen weitergibt.
     <td>Eine der folgenden Bibliotheken:
         <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="https://github.com/ged/bluecloth" title="bluecloth">BlueCloth</a>,
         <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a> oder
         <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
     </td>

data/README.es.md CHANGED

@@ -732,7 +732,7 @@ También toma un bloque para plantillas inline (ver [ejemplo](#plantillas-inline
 <table>
   <tr>
     <td>Dependencias</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>Extensiones de Archivo</td>
@@ -755,7 +755,7 @@ plantilla Liquid, casi siempre va a querer pasarle locales.
     <td>
       <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="https://github.com/ged/bluecloth" title="bluecloth">BlueCloth</a>,
       <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a> o
       <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
     </td>

data/README.fr.md CHANGED

@@ -691,7 +691,7 @@ exemple).
 <table>
   <tr>
     <td>Dépendances</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>Extensions de fichier</td>
@@ -716,7 +716,7 @@ locales.
       Au choix :
       <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="https://github.com/ged/bluecloth" title="bluecloth">BlueCloth</a>,
       <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
       <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
     </td>

data/README.ja.md CHANGED

@@ -610,7 +610,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>
@@ -627,7 +627,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>
@@ -661,7 +661,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>
@@ -684,8 +684,8 @@ LiquidテンプレートからRubyのメソッド(`yield`を除く)を呼び出
       次の何れか:
         <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>
@@ -786,7 +786,7 @@ RDocからはRubyを呼ぶことができないので、RDocで書かれたレ
 <table>
  <tr>
    <td>依存</td>
-   <td><a href="http://asciidoctor.org/" title="Asciidoctor">Asciidoctor</a></td>
+   <td><a href="https://asciidoctor.org/" title="Asciidoctor">Asciidoctor</a></td>
  </tr>
  <tr>
    <td>ファイル拡張子</td>
@@ -824,7 +824,7 @@ RadiusテンプレートからRubyのメソッドを直接呼び出すことが
 <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>
@@ -1456,7 +1456,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://www.ietf.org/rfc/rfc2324.txt"
   body "I'm a tea pot!"
 end
 ```
@@ -1586,7 +1586,7 @@ end
 ```ruby
 redirect to('/bar'), 303
-redirect 'http://www.google.com/', 'wrong place, buddy'
+redirect 'https://www.google.com/', 'wrong place, buddy'
 ```
 また、`redirect back`を使えば、簡単にユーザが来たページへ戻るリダイレクトを作れます。
@@ -2219,7 +2219,7 @@ Sinatraを開発環境の下で実行している場合は、特別な`not_found
 ## Rackミドルウェア(Rack Middleware)
-SinatraはRuby製Webフレームワークのミニマルな標準的インタフェースである[Rack](http://rack.github.io/)上に構築されています。アプリケーションデベロッパーにとってRackにおける最も興味深い機能は、「ミドルウェア(middleware)」をサポートしていることであり、これは、サーバとアプリケーションとの間に置かれ、HTTPリクエスト/レスポンスを監視および/または操作することで、各種の汎用的機能を提供するコンポーネントです。
+SinatraはRuby製Webフレームワークのミニマルな標準的インタフェースである[Rack](https://rack.github.io/)上に構築されています。アプリケーションデベロッパーにとってRackにおける最も興味深い機能は、「ミドルウェア(middleware)」をサポートしていることであり、これは、サーバとアプリケーションとの間に置かれ、HTTPリクエスト/レスポンスを監視および/または操作することで、各種の汎用的機能を提供するコンポーネントです。
 Sinatraはトップレベルの`use`メソッドを通して、Rackミドルウェアパイプラインの構築を楽にします。
@@ -2636,7 +2636,8 @@ ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
 ### マルチスレッド
-_この[StackOverflow][so-answer]でのKonstantinによる回答を言い換えています。_
+_この[StackOverflow](https://stackoverflow.com/a/6282999/5245129)
+のKonstantinによる回答を言い換えています。_
 Sinatraでは同時実行モデルを負わせることはできませんが、根本的な部分であるThinやPuma、WebrickのようなRackハンドラ(サーバー)部分に委ねることができます。
 Sinatra自身はスレッドセーフであり、もしRackハンドラが同時実行モデルのスレッドを使用していても問題はありません。
@@ -2663,8 +2664,6 @@ App.run!
 thin --threaded start
 ```
-[so-answer]: http://stackoverflow.com/questions/6278817/is-sinatra-multi-threaded/6282999#6282999)
 ## 必要環境
 次のRubyバージョンが公式にサポートされています。
@@ -2734,7 +2733,7 @@ gem install sinatra --pre
 ### Bundlerを使う場合
-最新のSinatraでアプリケーションを動作させたい場合には、[Bundler](http://bundler.io)を使うのがお薦めのやり方です。
+最新のSinatraでアプリケーションを動作させたい場合には、[Bundler](https://bundler.io)を使うのがお薦めのやり方です。
 まず、Bundlerがなければそれをインストールします。
@@ -2797,7 +2796,7 @@ sudo rake install
 ## バージョニング(Versioning)
-Sinatraは、[Semantic Versioning](http://semver.org/)におけるSemVerおよびSemVerTagの両方に準拠しています。
+Sinatraは、[Semantic Versioning](https://semver.org/)におけるSemVerおよびSemVerTagの両方に準拠しています。
 ## 参考文献
@@ -2805,7 +2804,7 @@ Sinatraは、[Semantic Versioning](http://semver.org/)におけるSemVerおよ
 * [プロジェクトに参加(貢献)する](http://www.sinatrarb.com/contributing.html) - バグレポート パッチの送信、サポートなど
 * [Issue tracker](https://github.com/sinatra/sinatra/issues)
 * [Twitter](https://twitter.com/sinatra)
-* [メーリングリスト](http://groups.google.com/group/sinatrarb/topics)
+* [メーリングリスト](https://groups.google.com/group/sinatrarb/topics)
 * http://freenode.net上のIRC: [#sinatra](irc://chat.freenode.net/#sinatra)
 * [Sinatra Book](https://github.com/sinatra/sinatra-book/) クックブック、チュートリアル
 * [Sinatra Recipes](http://recipes.sinatrarb.com/) コミュニティによるレシピ集

data/README.ko.md CHANGED

@@ -653,7 +653,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>의존성</td>
-    <td><a href="http://liquidmarkup.org/">liquid</a></td>
+    <td><a href="https://shopify.github.io/liquid/">liquid</a></td>
   </tr>
   <tr>
     <td>파일 확장자</td>
@@ -676,7 +676,7 @@ Liquid 템플릿에서는 루비 메서드(`yield` 제외)를 호출할 수 없
     <td>
       <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="https://github.com/ged/bluecloth" title="bluecloth">BlueCloth</a>,
       <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
       <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
       중 아무거나

data/README.md CHANGED

@@ -719,7 +719,7 @@ It also takes a block for inline templates (see [example](#inline-templates)).
 <table>
   <tr>
     <td>Dependency</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>File Extension</td>

data/README.pt-br.md CHANGED

@@ -655,7 +655,7 @@ It also takes a block for inline templates (see exemplo).
 <table>
   <tr>
     <td>Dependencia</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>Extencao do Arquivo</td>
@@ -679,7 +679,7 @@ você quase sempre precisará passar o `locals` para ele.
       Anyone of:
         <a href="https://github.com/davidfstr/rdiscount" title="RDiscount">RDiscount</a>,
         <a href="https://github.com/vmg/redcarpet" title="RedCarpet">RedCarpet</a>,
-        <a href="http://deveiate.org/projects/BlueCloth" title="BlueCloth">BlueCloth</a>,
+        <a href="https://github.com/ged/bluecloth" title="bluecloth">BlueCloth</a>,
         <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
         <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
     </td>

data/README.ru.md CHANGED

@@ -1,6 +1,6 @@
 # Sinatra
-[![Build Status](https://secure.travis-ci.org/sinatra/sinatra.svg)](http://travis-ci.org/sinatra/sinatra)
+[![Build Status](https://secure.travis-ci.org/sinatra/sinatra.svg)](https://travis-ci.org/sinatra/sinatra)
 *Внимание: Этот документ является переводом английской версии и может быть
 устаревшим*
@@ -24,7 +24,7 @@ end
 gem install sinatra
 ```
-и запустите приложение с помощью:
+и запустите приложение при помощи:
 ```shell
 ruby myapp.rb
@@ -32,9 +32,12 @@ ruby myapp.rb
 Оцените результат: [http://localhost:4567](http://localhost:4567)
-Рекомендуется также установить Thin, сделать это можно командой: `gem install
-thin`. Thin — это более производительный и функциональный сервер для
-разработки приложений на Sinatra.
+Имейте ввиду, что изменения в коде не будут видны до тех пор, пока вы не перезапустите
+сервер. Пожалуйста, перезагружайте сервер каждый раз как вносите изменения или добавьте
+в проект [sinatra/reloader](http://www.sinatrarb.com/contrib/reloader).
+Рекомендуется также установить Thin сервер  (`gem install thin`), который автоматически
+работает с Sinatra приложениями.
 ## Содержание
@@ -71,7 +74,7 @@ thin`. Thin — это более производительный и функц
             * [Yajl шаблоны](#yajl-шаблоны)
             * [WLang шаблоны](#wlang-шаблоны)
         * [Доступ к переменным в шаблонах](#Доступ-к-переменным-в-шаблонах)
-        * [Шаблоны с `yield` и вложенные раскладки (layout)](#Шаблоны-с-yield-и-вложенные-раскладки-layout)
+        * [Шаблоны с `yield` и вложенные лэйауты](#Шаблоны-с-yield-и-вложенные-лэйауты)
         * [Включённые шаблоны](#Включённые-шаблоны)
         * [Именованные шаблоны](#Именованные-шаблоны)
         * [Привязка файловых расширений](#Привязка-файловых-расширений)
@@ -80,14 +83,14 @@ thin`. Thin — это более производительный и функц
     * [Фильтры](#Фильтры)
     * [Методы-помощники](#Методы-помощники)
         * [Использование сессий](#Использование-сессий)
-          * [Секретная безопасность сессии](#Секретная-безопасность-сессии)
+          * [Безопасность сессии](#Безопасность-сессии)
           * [Конфигурация сессии](#Конфигурация-сессии)
-          * [Выбор вашей собственной "прослойки" сессии](#Выбор-вашей-собственной-прослойки-сессий)
+          * [Выбор вашей собственной "прослойки" сессии](#Выбор-вашей-собственной-прослойки-сессии)
         * [Прерывание](#Прерывание)
         * [Передача](#Передача)
         * [Вызов другого маршрута](#Вызов-другого-маршрута)
-        * [Задание тела, статус кода и заголовков ответа](#Задание-тела-статуса-кода-и-заголовков-ответа)
-        * [Стриминг ответов](#Стриминг-ответов)
+        * [Установка тела, статус кода и заголовков ответа](#Установка-тела-статус-кода-и-заголовков-ответа)
+        * [Потоковые ответы](#Потоковые-ответы)
         * [Логирование](#Логирование)
         * [Mime-типы](#mime-типы)
         * [Генерирование URL](#Генерирование-url)
@@ -97,7 +100,7 @@ thin`. Thin — это более производительный и функц
         * [Доступ к объекту запроса](#Доступ-к-объекту-запроса)
         * [Вложения](#Вложения)
         * [Работа со временем и датами](#Работа-со-временем-и-датами)
-        * [Поиск шаблонов](#Поиск-шаблонов)
+        * [Поиск файлов шаблонов](#Поиск-файлов-шаблонов)
     * [Конфигурация](#Конфигурация)
         * [Настройка защиты от атак](#Настройка-защиты-от-атак)
         * [Доступные настройки](#Доступные-настройки)
@@ -121,8 +124,8 @@ thin`. Thin — это более производительный и функц
     * [Командная строка](#Командная-строка)
         * [Многопоточность](#Многопоточность)
     * [Системные требования](#Системные-требования)
-    * [На острие](#На-острие)
-        * [С помощью Bundler](#С-помощью-bundler)
+    * [Самая свежая версия](#Самая-свежая-версия)
+        * [При помощи Bundler](#При-помощи-bundler)
     * [Версии](#Версии)
     * [Дальнейшее чтение](#Дальнейшее-чтение)
@@ -165,7 +168,7 @@ unlink '/' do
 end
 ```
-Маршруты сверяются с запросом в порядке очередности их записи в файле
+Маршруты сверяются с запросом в порядке очерёдности их записи в файле
 приложения. Первый же совпавший с запросом маршрут и будет вызван.
 Маршруты с конечным слэшем отличаются от маршрутов без него:
@@ -198,8 +201,8 @@ get '/hello/:name' do |n|
 end
 ```
-Шаблоны маршрутов также могут включать в себя splat (или '*' маску,
-обозначающую любой символ) параметры, доступные в массиве `params['splat']`:
+Шаблоны маршрутов также могут включать в себя splat параметры (или '*' маску,
+обозначающую любой символ), доступные в массиве `params['splat']`:
 ```ruby
 get '/say/*/to/*' do
@@ -221,7 +224,7 @@ get '/download/*.*' do |path, ext|
 end
 ```
-Регулярные выражения в качестве шаблонов маршрутов:
+Можно также использовать регулярные выражения в качестве шаблонов маршрутов:
 ```ruby
 get /\/hello\/([\w]+)/ do
@@ -257,9 +260,9 @@ get '/posts' do
 end
 ```
-Кстати, если вы не отключите защиту от обратного пути в директориях (path
-traversal, см. ниже), путь запроса может быть изменен до начала поиска
-подходящего маршрута.
+**Имеейте ввиду**: если вы не отключите защиту от обратного пути в директориях
+(_path traversal_, см. ниже), путь запроса может быть изменён до начала
+поиска подходящего маршрута.
 Вы можете настроить Mustermann опции, используемые для данного маршрута, путём передачи в `:mustermann_opts` хэш:
@@ -275,8 +278,8 @@ end
 ### Условия
-Маршруты могут включать различные условия совпадений, например, клиентское
-приложение (user agent):
+Маршруты могут включать в себя различные условия совпадений, такие как, например,
+строка агента пользователя (user agent):
 ```ruby
 get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
@@ -303,9 +306,10 @@ get '/', :provides => ['rss', 'atom', 'xml'] do
   builder :feed
 end
 ```
 `provides` ищет заголовок запроса `Accept`.
-Вы можете задать собственные условия:
+Вы можете с лёгкостью задавать собственные условия:
 ```ruby
 set(:probability) { |value| condition { rand <= value } }
@@ -319,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
@@ -342,8 +346,8 @@ end
 ### Возвращаемые значения
 Возвращаемое значение блока маршрута ограничивается телом ответа, которое
-будет передано HTTP клиенту, или следующей "прослойкой" (middleware) в Rack
-стеке. Чаще всего это строка, как в примерах выше. Но также приемлемы и
+будет передано HTTP клиенту, или, по крайней мере, следующей "прослойке" (middleware)
+в Rack стеке. Чаще всего это строка как в примерах выше. Но также приемлемы и
 другие значения.
 Вы можете вернуть любой объект, который будет либо корректным Rack ответом,
@@ -357,8 +361,7 @@ end
   данных в этот блок;
 * Fixnum, представляющий код состояния HTTP.
-Таким образом, легко можно реализовать, например, поточный пример:
+Таким образом легко можно реализовать, например, потоковую передачу:
 ```ruby
 class Stream
@@ -370,14 +373,14 @@ end
 get('/') { Stream.new }
 ```
-Вы также можете использовать метод `stream` (описываемый ниже), чтобы
-уменьшить количество шаблонного кода и встраивать поточную логику прямо в
-маршрут.
+Вы также можете использовать вспомогательный метод `stream` (описанный ниже)
+для того, чтобы уменьшить количество шаблонного кода и встроить потоковую
+логику прямо в маршрут.
 ### Собственные детекторы совпадений для маршрутов
 Как показано выше, Sinatra поставляется со встроенной поддержкой строк и
-регулярных выражений в качестве шаблонов URL. Но и это еще не все. Вы можете
+регулярных выражений в качестве шаблонов URL. Но и это ещё не всё. Вы можете
 легко определить свои собственные детекторы совпадений (matchers) для
 маршрутов:
@@ -404,8 +407,8 @@ get all_but("/index") do
 end
 ```
-Заметьте, что предыдущий пример, возможно, чересчур усложнен, потому что он
-может быть реализован так:
+Обратите внимание на то, что предыдущий пример, возможно, чересчур усложнён, потому что он
+может быть реализован следующим образом:
 ```ruby
 get // do
@@ -414,7 +417,7 @@ get // do
 end
 ```
-Или с использованием негативного просмотра вперед:
+Или с использованием негативной опережающей проверки (отрицательное look-ahead условие):
 ```ruby
 get %r{(?!/index)} do
@@ -424,8 +427,8 @@ end
 ## Статические файлы
-Статические файлы отдаются из `./public` директории. Вы можете указать другое
-место, используя опцию `:public_folder`:
+Статические файлы раздаются из `./public` директории. Вы можете указать другое
+месторасположение при помощи опции `:public_folder`:
 ```ruby
 set :public_folder, File.dirname(__FILE__) + '/static'
@@ -435,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`.
 ## Представления / Шаблоны
@@ -449,7 +452,7 @@ get '/' do
 end
 ```
-Отобразит `views/index.erb`.
+Данный код отрендерит файл `views/index.erb`.
 Вместо имени шаблона вы так же можете передавать непосредственно само
 содержимое шаблона:
@@ -461,7 +464,7 @@ get '/' do
 end
 ```
-Эти методы принимают второй аргумент, хеш с опциями:
+Метод рендеринга шаблона принимает в качестве второго аргумента хэш с опциями:
 ```ruby
 get '/' do
@@ -469,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
@@ -480,7 +483,7 @@ get '/' do
 end
 ```
-Вы также можете задавать опции для шаблонизаторов в общем:
+Вы также можете глобально задавать опции для шаблонизаторов:
 ```ruby
 set :haml, :format => :html5
@@ -490,7 +493,7 @@ get '/' do
 end
 ```
-Опции, переданные в метод, переопределяют опции, заданные с помощью `set`.
+Опции, переданные в метод, переопределяют опции, заданные при помощи `set`.
 Доступные опции:
@@ -498,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>
@@ -514,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>
@@ -534,29 +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'`). Вы должны использовать
+символы в связи с тем, что в ином случае шаблонизаторы попросту отображают
+любые строки, переданные им.
 ### Буквальные шаблоны
@@ -566,9 +571,10 @@ get '/' do
 end
 ```
-Отобразит шаблон, переданный строкой. Опционально, можно задать `:path` и
-`:line` для более понятного бэктрейса, в случае, если существует путь к
-файловой системе и линия, которые ассоциируются с этой строкой:
+Отобразит шаблон, содержимое которого передано строкой. Опционально можно
+указать дополнительные опции `:path` и `:line` для того, чтобы улучшить бэктрейс.
+Делайте это в том случае, если строка определена в некотором файле, к которому
+можно указать путь и номер строки, где расположена исходная строка:
 ```ruby
 get '/' do
@@ -578,8 +584,9 @@ end
 ### Доступные шаблонизаторы
-Некоторые языки шаблонов имеют несколько реализаций. Чтобы указать, какую
-реализацию использовать, вам следует просто подключить нужную библиотеку:
+Некоторые языки шаблонов имеют несколько реализаций. Для того, чтобы указать
+конкретную реализацию, которую вы хотите использовать, вам следует просто
+подключить нужную библиотеку:
 ```ruby
 require 'rdiscount' # или require 'bluecloth'
@@ -610,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>
@@ -642,7 +649,7 @@ get('/') { markdown :index }
   </tr>
 </table>
-Блок также используется и для встроенных шаблонов (см. пример).
+Шаблонизатор также принимает блоки для включённых шаблонов ([см. пример](#Включённые-шаблоны)).
 #### Nokogiri шаблоны
@@ -661,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>
@@ -685,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>
@@ -719,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>
@@ -731,8 +738,9 @@ get('/') { markdown :index }
   </tr>
 </table>
-Так как в Liquid шаблонах невозможно вызывать методы из Ruby (кроме `yield`), то
-вы почти всегда будете передавать в шаблон локальные переменные.
+В связи с тем, что в Liquid шаблонах невозможно вызывать методы из Ruby
+(за исключением `yield`), вам почти всегда понадобиться передавать в шаблон
+локальные переменные.
 #### Markdown шаблоны
@@ -743,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>
@@ -759,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 шаблоны
@@ -796,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 шаблоны
@@ -833,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 шаблоны
@@ -897,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>
@@ -909,7 +917,7 @@ erb :overview, :locals => { :text => rdoc(:introduction) }
   </tr>
 </table>
-Блок также используется и для встроенных шаблонов (см. пример).
+Шаблонизатор также принимает блоки для включённых шаблонов ([см. пример](#Включённые-шаблоны)).
 #### RABL шаблоны
@@ -963,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 шаблоны
@@ -1000,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 шаблоны
@@ -1028,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>
@@ -1052,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>
@@ -1067,8 +1075,8 @@ erb :overview, :locals => { :text => mediawiki(:introduction) }
   </tr>
 </table>
-Перед тем, как использовать шаблоны стилус, загрузите `stylus` и
-`stylus/tilt`:
+Перед тем, как использовать шаблоны Stylus, необходимо сперва подключить
+`stylus` и `stylus/tilt`:
 ```ruby
 require 'sinatra'
@@ -1105,7 +1113,7 @@ end
 </table>
 Содержимое шаблона интерпретируется как код на Ruby, а результирующая
-переменная json затем конвертируется с помощью `#to_json`.
+переменная json затем конвертируется при помощи `#to_json`.
 ```ruby
 json = { :foo => 'bar' }
@@ -1113,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 шаблоны
@@ -1124,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>
@@ -1138,7 +1147,7 @@ var resource = {"foo":"bar","baz":"qux"}; present(resource);
 Так как в WLang шаблонах невозможно вызывать методы из Ruby напрямую (за
 исключением `yield`), то вы почти всегда будете передавать в шаблон локальные
-переменные.
+переменные. Лэйауты также могут быть описаны при помощи WLang.
 ### Доступ к переменным в шаблонах
@@ -1153,7 +1162,7 @@ get '/:id' do
 end
 ```
-Либо установите их через хеш локальных переменных:
+Вы также можете установить их при помощи хэша локальных переменных:
 ```ruby
 get '/:id' do
@@ -1162,14 +1171,13 @@ get '/:id' do
 end
 ```
-Это обычный подход, когда шаблоны рендерятся как части других шаблонов.
+Это обычный подход, применяемый тогда, когда шаблоны рендерятся как части других шаблонов.
-### Шаблоны с `yield` и вложенные раскладки (layout)
+### Шаблоны с `yield` и вложенные лэйауты
-Раскладка (layout) обычно представляет собой шаблон, который исполняет
-`yield`.
-Такой шаблон может быть либо использован с помощью опции `:template`,
-как описано выше, либо он может быть дополнен блоком:
+Лэйаут (layout) обычно представляет собой шаблон, который исполняет
+`yield`. Такой шаблон может быть использован либо при помощи опции `:template`,
+как описано выше, либо при помощи блока:
 ```ruby
 erb :post, :layout => false do
@@ -1177,10 +1185,10 @@ erb :post, :layout => false do
 end
 ```
-Эти инструкции в основном эквивалентны `erb :index, :layout => :post`.
+Эти инструкции по сути эквивалентны `erb :index, :layout => :post`.
 Передача блоков интерпретирующим шаблоны методам наиболее полезна для
-создания вложенных раскладок:
+создания вложенных лэйаутов:
 ```ruby
 erb :main_layout, :layout => false do
@@ -1190,7 +1198,7 @@ erb :main_layout, :layout => false do
 end
 ```
-Это же самое может быть сделано короче:
+То же самое может быть сделано в более короткой форме:
 ```ruby
 erb :admin_layout, :layout => :main_layout do
@@ -1198,10 +1206,9 @@ erb :admin_layout, :layout => :main_layout do
 end
 ```
-В настоящее время, следующие интерпретирующие шаблоны методы
-принимают блок:
-`erb`, `haml`, `liquid`, `slim `, `wlang`.
-Общий метод заполнения шаблонов `render` также принимает блок.
+В настоящее время следующие методы шаблонизаторов
+принимают блок: `erb`, `haml`, `liquid`, `slim `, `wlang`. Кроме того,
+общий метод построения шаблонов `render` также принимает блок.
 ### Включённые шаблоны
@@ -1224,13 +1231,13 @@ __END__
 %div.title Hello world.
 ```
-Заметьте: включённые шаблоны, определенные в исходном файле, который подключил
+Обратите внимание: включённые шаблоны, определённые в исходном файле, который подключил
 Sinatra, будут загружены автоматически. Вызовите `enable :inline_templates`
-напрямую, если используете включённые шаблоны в других файлах.
+напрямую в том случае, если используете включённые шаблоны в других файлах.
 ### Именованные шаблоны
-Шаблоны также могут быть определены при помощи `template` метода:
+Шаблоны также могут быть определены при помощи метода `template`:
 ```ruby
 template :layout do
@@ -1247,8 +1254,8 @@ end
 ```
 Если шаблон с именем "layout" существует, то он будет использоваться каждый
-раз при рендеринге. Вы можете отключать лэйаут в каждом конкретном случае с
-помощью `:layout => false` или отключить его для всего приложения: `set :haml,
+раз при рендеринге. Вы можете отключать лэйаут в каждом конкретном случае при
+помощи опции `:layout => false` или отключить его для всего приложения: `set :haml,
 :layout => false`:
 ```ruby
@@ -1259,9 +1266,9 @@ end
 ### Привязка файловых расширений
-Чтобы связать расширение файла с движком рендеринга, используйте
-`Tilt.register`. Например, если вы хотите использовать расширение `tt` для
-шаблонов Textile:
+Для того, чтобы связать расширение файла с движком рендеринга, используйте
+`Tilt.register`. Так, например, вызовите следующий код в том случае, если вы
+хотите использовать расширение `tt` для шаблонов Textile:
 ```ruby
 Tilt.register :tt, Tilt[:textile]
@@ -1269,7 +1276,7 @@ Tilt.register :tt, Tilt[:textile]
 ### Добавление собственного движка рендеринга
-Сначала зарегистрируйте свой движок в Tilt, а затем создайте метод, отвечающий
+Сначала зарегистрируйте собственный движок в Tilt, а затем создайте метод, отвечающий
 за рендеринг:
 ```ruby
@@ -1284,13 +1291,13 @@ get '/' do
 end
 ```
-Отобразит `./views/index.myat`. Чтобы узнать больше о Tilt, смотрите
-https://github.com/rtomayko/tilt
+Данный код отрендерит `./views/index.myat`.
+Подробнее о [Tilt](https://github.com/rtomayko/tilt#readme).
 ### Использование пользовательской логики для поиска шаблона
-Для того, чтобы реализовать свой собственный механизм поиска шаблона,
-необходимо написать свой собственный `#find_template` метод:
+Для того, чтобы реализовать собственный механизм поиска шаблона,
+необходимо написать метод `#find_template`:
 ```ruby
 configure do
@@ -1333,12 +1340,12 @@ after do
 end
 ```
-Заметьте: если вы используете метод `body`, а не просто возвращаете строку из
+Обратите внимание: если вы используете метод `body`, а не просто возвращаете строку из
 маршрута, то тело ответа не будет доступно в `after`-фильтрах, так как оно
 будет сгенерировано позднее.
-Фильтры могут использовать шаблоны URL и будут интерпретированы, только если
-путь запроса совпадет с этим шаблоном:
+Фильтры также могут использовать шаблоны URL и будут выполнены только в том случае,
+если путь запроса совпадет с указанным шаблоном:
 ```ruby
 before '/protected/*' do
@@ -1364,8 +1371,9 @@ end
 ## Методы-помощники
-Используйте высокоуровневый метод `helpers`, чтобы определить
-методы-помощники для использования в обработчиках маршрутов и шаблонах:
+Используйте высокоуровневый метод `helpers` для того, чтобы определить
+методы-помощники, которые могут быть использованы в обработчиках маршрутов
+и шаблонах:
 ```ruby
 helpers do
@@ -1397,8 +1405,8 @@ helpers FooUtils, BarUtils
 ### Использование сессий
-Сессия используется, чтобы сохранять состояние между запросами. Если эта опция
-включена, то у вас будет один хеш сессии на одну пользовательскую сессию:
+Сессия используется для того, чтобы сохранять состояние между запросами. Если
+эта опция включена, то у вас будет один хэш сессии на один пользовательский сеанс:
 ```ruby
 enable :sessions
@@ -1412,30 +1420,30 @@ get '/:value' do
 end
 ```
-### Секретная безопасность сессии
+### Безопасность сессии
-Чтобы повысить безопасность, данные сессии в файле 'cookie' подписываются
-ключом сессии с использованием `HMAC-SHA1`. Этот ключ сессии должен быть
-оптимальным криптографическим 'secure random' значением соответствующей
+Для того, чтобы повысить безопасность, данные сессии в файле 'cookie'
+подписываются ключом сессии с использованием `HMAC-SHA1`. Этот ключ сессии
+должен быть оптимальным криптографическим 'secure random' значением соответствующей
 длины, которая для `HMAC-SHA1` больше или равна 64 байтам (512 бит, 128
 шестнадцатеричных символов). Не рекомендуется использовать ключ, длина
 которого менее 32 байт (256 бит, 64 шестнадцатеричных символа). Поэтому
 **очень важно**, чтобы вы не просто составили значение ключа, а использовали
-генератор 'secure random' чисел для его создания. Люди очень плохо генерируют
-случайные значения.
-По умолчанию, Sinatra создаёт для вас 'secure random' ключ сессии из 32 байт,
-но он будет меняться при каждом перезапуске приложения. Если у вас есть
-несколько экземпляров вашего приложения, и вы позволяете чтобы Sinatra
-генерировала ключ, то каждый экземпляр будет иметь отличный ключ сессии,
-который, вероятно, не тот, который вы хотите.
+безопасный генератор случайных чисел для его создания. Люди очень плохо
+придумывают случайные значения.
+По умолчанию, Sinatra создаёт для вас безопасный случайный ключ сессии из
+32 байт, однако он будет меняться при каждом перезапуске приложения. Если у
+вас есть несколько экземпляров вашего приложения, и вы доверили Sinatra
+генерацию ключа, то каждый экземпляр будет иметь отличный ключ сессии,
+что, вероятно, не совсем то, что вам необходимо.
 Для лучшей безопасности и удобства использования
-[рекомендуется](https://12factor.net/config) генерировать 'secure random'
+[рекомендуется](https://12factor.net/config) генерировать случайный безопасный
 ключ и хранить его в переменной среды на каждом хосте, на котором запущено
 приложение, чтобы все экземпляры вашего приложения использовали один и тот
-же ключ. Вы должны периодически менять значение ключа сессии.
-Вот несколько примеров того, как вы можете создать ключ на 64 байта
+же ключ. Вы должны периодически менять значение ключа сессии на новое.
+Вот несколько примеров того, как вы можете создать 64-байтный ключ
 и установить его:
 **Генерация ключа сессии**
@@ -1447,10 +1455,10 @@ $ ruby -e "require 'securerandom'; puts SecureRandom.hex(64)"
 **Генерация ключа сессии (бонусные пункты)**
-Используйте [гем 'sysrandom'](https://github.com/cryptosphere/sysrandom)
+Используйте [гем 'sysrandom'](https://github.com/cryptosphere/sysrandom#readme).
 Предпочтительнее использовать системные средства RNG для генерации случайных
-значений вместо пространства пользователя `OpenSSL`, для которого в данный
-момент по умолчанию используется MRI Ruby:
+значений вместо пространства пользователя `OpenSSL`, который в настоящее время
+по умолчанию используется в MRI Ruby:
 ```text
 $ gem install sysrandom
@@ -1462,11 +1470,12 @@ $ ruby -e "require 'sysrandom/securerandom'; puts SecureRandom.hex(64)"
 99ae8af...snip...ec0f262ac
 ```
-**Переменная среды `SESSION_SECRET`**
+**Переменная среды для ключа сессии**
-Задайте переменной среды для Sinatra `SESSION_SECRET` значение, которое вы
-сгенерировали. Сделайте это значение постоянным при перезагрузке вашего
-хоста. Поскольку метод для генерации будет различным в разных системах,
+Задайте переменной среды `SESSION_SECRET` значение, которое вы
+сгенерировали. Данная переменная автоматически будет использована Sinatra.
+Сделайте это значение постоянным при перезагрузке вашего
+сервера. Поскольку метод для генерации будет различным в разных системах,
 то код ниже приведён только в качестве примера:
 ```bash
@@ -1475,11 +1484,12 @@ $ ruby -e "require 'sysrandom/securerandom'; puts SecureRandom.hex(64)"
 **Конфигурация приложения**
-Настройте конфигурацию вашего приложения в безопасном режиме для
-'secure random' ключа если переменная среды `SESSION_SECRET` не доступна.
+В целях безопасности настройте конфигурацию вашего приложения таким образом,
+чтобы оно генерировало случайный безопасный ключ тогда, когда переменная
+среды `SESSION_SECRET` не доступна.
 В качестве бонусных пунктов здесь тоже используйте
-[гем 'sysrandom'gem](https://github.com/cryptosphere/sysrandom) :
+[гем 'sysrandom'gem](https://github.com/cryptosphere/sysrandom):
 ```ruby
 require 'securerandom'
@@ -1489,7 +1499,7 @@ set :session_secret, ENV.fetch('SESSION_SECRET') { SecureRandom.hex(64) }
 #### Конфигурация сессии
-Если вы хотите больше настроек для сессий, вы можете задать их, передав хеш
+Если вы хотите больше настроек для сессий, вы можете задать их, передав хэш
 опций в параметр `sessions`:
 ```ruby
@@ -1505,9 +1515,9 @@ set :sessions, :domain => '.foo.com'
 #### Выбор вашей собственной "прослойки" сессии
-Заметьте, что при использовании `enable :sessions` все данные сохраняются в
-куках (cookies). Это может быть не совсем то, что вы хотите (например,
-сохранение больших объемов данных увеличит ваш трафик). В таком случае вы
+Обратите внимание на то, что при использовании `enable :sessions` все данные
+сохраняются в куках (cookies). Это может быть не совсем то, что вы хотите (например,
+сохранение больших объёмов данных увеличит ваш трафик). В таком случае вы
 можете использовать альтернативную Rack "прослойку" (middleware), реализующую
 механизм сессий. Для этого используете один из способов ниже:
@@ -1516,20 +1526,20 @@ enable :sessions
 set :session_store, Rack::Session::Pool
 ```
-Или установите параметры сессии с помощью хеша опций:
+Или установите параметры сессии при помощи хэша опций:
 ```ruby
 set :sessions, :expire_after => 2592000
 set :session_store, Rack::Session::Pool
 ```
-Вы так же можете не вызывать `enable :sessions`, а вместо этого вызывать
-необходимую вам прослойку так же, как вы это обычно делаете.
+Вы также можете **не вызывать** `enable :sessions`, а вместо этого использовать
+необходимую вам Rack прослойку так же, как вы это обычно делаете.
 Очень важно обратить внимание на то, что когда вы используете этот метод,
-основной способ защиты сессии **не будет включен по умолчанию**.
+основной способ защиты сессии **не будет включён по умолчанию**.
-Если вы хотите включить защиту, вам нужно добавить следующие строчки:
+Вам также потребуется добавить следующие Rack middleware для этого:
 ```ruby
 use Rack::Session::Pool, :expire_after => 2592000
@@ -1537,12 +1547,12 @@ use Rack::Protection::RemoteToken
 use Rack::Protection::SessionHijacking
 ```
-Смотрите секцию "Настройка защиты от атак" для более подробной информации.
+Смотрите раздел ["Настройка защиты от атак"](#Настройка-защиты-от-атак) для более подробной информации.
 ### Прерывание
 Чтобы незамедлительно прервать обработку запроса внутри фильтра или маршрута,
-используйте:
+используйте следующую команду:
 ```ruby
 halt
@@ -1580,8 +1590,8 @@ halt erb(:error)
 ### Передача
-Маршрут может передать обработку запроса следующему совпадающему маршруту,
-используя `pass`:
+Маршрут может передать обработку запроса следующему совпадающему маршруту
+используя метод `pass`:
 ```ruby
 get '/guess/:who' do
@@ -1594,7 +1604,7 @@ get '/guess/*' do
 end
 ```
-Блок маршрута сразу же прерывается, и контроль переходит к следующему
+Блок маршрута сразу же прерывается, а контроль переходит к следующему
 совпадающему маршруту. Если соответствующий маршрут не найден, то ответом на
 запрос будет 404.
@@ -1614,8 +1624,8 @@ get '/bar' do
 end
 ```
-Заметьте, что в предыдущем примере можно облегчить тестирование и повысить
-производительность, перенеся `"bar"` в метод-помощник, используемый и в
+Обратите внимание на то, что в предыдущем примере можно облегчить тестирование и
+повысить производительность, перенеся `"bar"` в метод-помощник, используемый и в
 `/foo`, и в `/bar`.
 Если вы хотите, чтобы запрос был отправлен в тот же экземпляр приложения,
@@ -1623,14 +1633,14 @@ end
 Если хотите узнать больше о `call`, смотрите спецификацию Rack.
-### Задание тела, кода и заголовков ответа
+### Установка тела, статус кода и заголовков ответа
 Хорошим тоном является установка кода состояния HTTP и тела ответа в
 возвращаемом значении обработчика маршрута. Тем не менее, в некоторых
 ситуациях вам, возможно, понадобится задать тело ответа в произвольной точке
-потока исполнения. Вы можете сделать это с помощью метода-помощника `body`.
+потока исполнения. Вы можете сделать это при помощи метода-помощника `body`.
 Если вы задействуете метод `body`, то вы можете использовать его и в
-дальнейшем, чтобы получить доступ к телу ответа.
+дальнейшем, чтобы получить доступ к телу ответа:
 ```ruby
 get '/foo' do
@@ -1644,7 +1654,7 @@ end
 Также можно передать блок в метод `body`, который затем будет вызван
 обработчиком Rack (такой подход может быть использован для реализации
-поточного ответа, см. "Возвращаемые значения").
+потокового ответа, см. ["Возвращаемые значения"](#Возвращаемые-значения)).
 Аналогично вы можете установить код ответа и его заголовки:
@@ -1653,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
 ```
@@ -1661,12 +1671,12 @@ end
 Как и `body`, методы `headers` и `status`, вызванные без аргументов,
 возвращают свои текущие значения.
-### Стриминг ответов
+### Потоковые ответы
 Иногда требуется начать отправлять данные клиенту прямо в процессе
 генерирования частей этих данных. В особых случаях требуется постоянно
 отправлять данные до тех пор, пока клиент не закроет соединение. Вы можете
-использовать метод `stream` вместо написания собственных "оберток".
+использовать метод `stream` вместо разработки собственных "обёрток".
 ```ruby
 get '/' do
@@ -1680,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.
@@ -1696,7 +1706,7 @@ end
 Если метод используется с параметром `keep_open`, то он не будет вызывать
 `close` у объекта потока, что позволит вам закрыть его позже в любом другом
 месте. Это работает только с событийными серверами, например, с Thin и
-Rainbows. Другие же серверы все равно будут закрывать поток:
+Rainbows. Другие же серверы всё равно будут закрывать поток:
 ```ruby
 # long polling
@@ -1708,7 +1718,7 @@ get '/subscribe' do
   # регистрация клиента в событиях сервера
   stream(:keep_open) do |out|
     connections << out
-    # удаление "мертвых клиентов"
+    # удаление "мёртвых клиентов"
     connections.reject!(&:closed?)
   end
 end
@@ -1728,7 +1738,7 @@ end
 ```
 Также клиент может закрыть соединение при попытке записи в сокет. В связи с
-этим рекомендуется проверить `out.closed?` прежде, чем пытаться записать.
+этим рекомендуется выполнить проверку `out.closed?` прежде, чем пытаться произвести запись.
 ### Логирование
@@ -1746,9 +1756,9 @@ end
 логирование выключено, то этот метод вернет пустой (dummy) объект, поэтому вы
 можете смело использовать его в маршрутах и фильтрах.
-Заметьте, что логирование включено по умолчанию только для
-`Sinatra::Application`, а если ваше приложение — подкласс `Sinatra::Base`, то
-вы, наверное, захотите включить его вручную:
+Обратите внимание на то, что логирование включено по умолчанию только для
+`Sinatra::Application`. Если ваше приложение является подклассом `Sinatra::Base`, то
+вы, скорее всего, захотите включить его вручную:
 ```ruby
 class MyApp < Sinatra::Base
@@ -1759,8 +1769,8 @@ end
 ```
 Чтобы избежать использования любой логирующей "прослойки", задайте опции
-`logging` значение `nil`. Тем не менее, не забывайте, что в такой ситуации
-`logger` вернет `nil`. Чаще всего так делают, когда задают свой собственный
+`logging` значение `nil`. При этом не забывайте, что в такой ситуации
+`logger` будет возвращать `nil`. Чаще всего так делают, когда задают свой собственный
 логер. Sinatra будет использовать то, что находится в `env['rack.logger']`.
 ### Mime-типы
@@ -1775,7 +1785,7 @@ configure do
 end
 ```
-Вы также можете использовать это в `content_type` методе-помощнике:
+Вы также можете использовать это в методе-помощнике `content_type`:
 ```ruby
 get '/' do
@@ -1799,7 +1809,7 @@ end
 ### Перенаправление (редирект)
-Вы можете перенаправить браузер пользователя с помощью метода `redirect`:
+Вы можете перенаправить браузер пользователя при помощи метода `redirect`:
 ```ruby
 get '/foo' do
@@ -1816,7 +1826,7 @@ redirect 'http://www.google.com/', 'wrong place, buddy'
 ```
 Вы также можете перенаправить пользователя обратно на страницу, с которой он
-пришел, с помощью `redirect back`:
+пришёл, при помощи `redirect back`:
 ```ruby
 get '/foo' do
@@ -1829,8 +1839,8 @@ get '/bar' do
 end
 ```
-Чтобы передать какие-либо параметры вместе с перенаправлением, либо добавьте
-их в строку запроса:
+Для того, чтобы передать какие-либо параметры вместе с перенаправлением,
+добавьте их в строку запроса:
 ```ruby
 redirect to('/bar?sum=42')
@@ -1855,7 +1865,7 @@ end
 Установка корректных заголовков — основа правильного HTTP кэширования.
-Вы можете легко выставить заголовок Cache-Control таким образом:
+Вы можете легко выставить заголовок Cache-Control следующим образом:
 ```ruby
 get '/' do
@@ -1881,10 +1891,11 @@ before do
 end
 ```
-Чтобы как следует использовать кэширование, вам следует подумать об
-использовании `etag` или `last_modified`. Рекомендуется использовать эти
-методы-помощники *до* выполнения ресурсоемких вычислений, так как они
-немедленно отправят ответ клиенту, если текущая версия уже есть в их кэше:
+Чтобы использовать кэширование правильно, вам стоит подумать о
+применении `etag` или `last_modified`. Рекомендуется использовать эти
+методы-помощники *до* выполнения ресурсоёмких вычислений, так как они
+немедленно отправят ответ клиенту в том случае, если текущая версия
+уже присутствует в их кэше:
 ```ruby
 get "/article/:id" do
@@ -1902,9 +1913,9 @@ 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"
@@ -1925,9 +1936,9 @@ end
 В соответствии с RFC 2616 ваше приложение должно вести себя по-разному, когда
 заголовки If-Match или If-None-Match имеют значение `*`, в зависимости от
 того, существует или нет запрашиваемый ресурс. Sinatra предполагает, что
-ресурсы, к которым обращаются с помощью безопасных (GET) и идемпотентных (PUT)
+ресурсы, к которым обращаются при помощи безопасных (GET) и идемпотентных (PUT)
 методов, уже существуют, а остальные ресурсы (к которым обращаются, например,
-с помощью POST) считает новыми. Вы можете изменить данное поведение с помощью
+при помощи POST) считает новыми. Вы можете изменить данное поведение при помощи
 опции `:new_resource`:
 ```ruby
@@ -1984,8 +1995,8 @@ send_file 'foo.png', :type => :jpg
   <dt>status</dt>
     <dd>
-    Код ответа. Полезно, когда отсылается статический файл в качестве страницы с
-      сообщением об ошибке. Если поддерживается обработчик Rack, будут использоваться
+    Код ответа. Полезно в том случае, когда отсылается статический файл в качестве
+    страницы с сообщением об ошибке. Если поддерживается обработчик Rack, будут использоваться
     другие средства, кроме потоковой передачи из процесса Ruby. Если вы используете
     этот вспомогательный метод, Sinatra автоматически обрабатывает запросы диапазона.
     </dd>
@@ -1994,7 +2005,7 @@ send_file 'foo.png', :type => :jpg
 ### Доступ к объекту запроса
 Объект входящего запроса доступен на уровне обработки запроса (в фильтрах,
-маршрутах, обработчиках ошибок) с помощью `request` метода:
+маршрутах, обработчиках ошибок) при помощи `request` метода:
 ```ruby
 # приложение запущено на http://example.com/example
@@ -2015,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 = "/" }
@@ -2052,8 +2063,8 @@ end
 ### Вложения
-Вы можете использовать метод `attachment`, чтобы сказать браузеру, что ответ
-сервера должен быть сохранен на диск, а не отображен:
+Вы можете использовать метод `attachment`, чтобы сообщить браузеру о том,
+что ответ сервера должен быть сохранён на диск, а не отображён:
 ```ruby
 get '/' do
@@ -2075,7 +2086,7 @@ end
 Sinatra предлагает метод-помощник `time_for`, который из заданного значения
 создает объект Time. Он также может конвертировать `DateTime`, `Date` и
-подобные классы:
+схожие классы:
 ```ruby
 get '/' do
@@ -2086,7 +2097,7 @@ end
 Этот метод используется внутри Sinatra методами `expires`, `last_modified` и
 им подобными. Поэтому вы легко можете изменить и дополнить поведение этих методов,
-переопределив `time_for` в своем приложении:
+переопределив `time_for` в своём приложении:
 ```ruby
 helpers do
@@ -2106,7 +2117,7 @@ get '/' do
 end
 ```
-### Поиск шаблонов
+### Поиск файлов шаблонов
 Для поиска шаблонов и их последующего рендеринга используется метод
 `find_template`:
@@ -2149,18 +2160,17 @@ end
 Вы можете легко вынести этот код в расширение и поделиться им с остальными!
-Заметьте, что `find_template` не проверяет, существует ли файл на самом деле,
-а вызывает заданный блок для всех возможных путей. Дело тут не в
-производительности, дело в том, что `render` вызовет `break`, как только файл
-будет найден. Содержимое и местонахождение шаблонов будет закэшировано, если
-приложение запущено не в режиме разработки (`set :environment, :development`).
+Обратите внимание на тот факт, что `find_template` не проверяет, существует ли
+файл на самом деле, а вызывает заданный блок для всех возможных путей. Дело тут не в
+производительности, а в том, что `render` вызовет `break` как только файл
+будет найден. Содержимое и местонахождение шаблонов будет закэшировано в том случае,
+если приложение запущено не в режиме разработки (`set :environment, :development`).
 Вы должны помнить об этих нюансах, если пишите по-настоящему "сумасшедший"
 метод.
 ## Конфигурация
-Этот блок исполняется один раз при старте в любом окружении, режиме
-(environment):
+Этот блок исполняется один раз при старте в любом окружении (environment):
 ```ruby
 configure do
@@ -2181,7 +2191,8 @@ configure do
 end
 ```
-Будет запущено, когда окружение (`APP_ENV` переменная) `:production`:
+Следующий пример будет выполнен только тогда, когда окружение
+(переменная `APP_ENV`) будет задана как `:production`:
 ```ruby
 configure :production do
@@ -2189,7 +2200,8 @@ configure :production do
 end
 ```
-Будет запущено, когда окружение `:production` или `:test`:
+Следующий код будет выполнен в том случае, когда окружение
+будет задано как `:production` или `:test`:
 ```ruby
 configure :production, :test do
@@ -2197,7 +2209,7 @@ configure :production, :test do
 end
 ```
-Вы можете получить доступ к этим опциям с помощью `settings`:
+Вы можете получить доступ к этим опциям при помощи метода `settings`:
 ```ruby
 configure do
@@ -2216,14 +2228,14 @@ end
 Sinatra использует
 [Rack::Protection](https://github.com/sinatra/rack-protection#readme) для защиты
 приложения от простых атак. Вы можете легко выключить эту защиту (что сделает
-ваше приложение чрезвычайно уязвимым):
+ваше приложение чрезвычайно уязвимым к большому числу различных уязвимостей):
 ```ruby
 disable :protection
 ```
-Чтобы пропустить какой-либо уровень защиты, передайте хеш опций в параметр
-`protection`:
+Чтобы отключить какой-либо конкретный уровень защиты, передайте хэш опций
+в параметр `protection`:
 ```ruby
 set :protection, :except => :path_traversal
@@ -2236,10 +2248,10 @@ set :protection, :except => [:path_traversal, :session_hijacking]
 ```
 По умолчанию Sinatra будет устанавливать `session based` защиту только если
-включена опция `:sessions`. См. 'Использование сессий'. Иногда вы захотите
-настроить сессии "вне" приложения Sinatra, например, в config.ru или с помощью
-отдельного экземпляра `Rack::Builder`. В этом случае вы также можете настроить
-`session based` защиту, передав опцию `:session`:
+включена опция `:sessions`. См. ["Использование сессий""](#Использование-сессий).
+Иногда вы захотите  настроить сессии "вне" приложения Sinatra, например, в
+config.ru или при помощи отдельного экземпляра `Rack::Builder`. В таком случае
+вы также можете настроить `session based` защиту, передав опцию `:session`:
 ```ruby
 set :protection, :session => true
@@ -2256,9 +2268,9 @@ set :protection, :session => true
     </dd>
     <dd>
       включайте эту опцию, если ваше приложение работает за обратным прокси,
-      который настроен не совсем корректно. Обратите внимание, метод <tt>url</tt> все
-      равно будет генерировать абсолютные URL, если вы не передадите <tt>false</tt>
-      вторым аргументом.
+      который настроен не совсем корректно. Обратите внимание на тот факт, что
+      метод <tt>url</tt> всё равно будет генерировать абсолютные URL в том случае,
+      если вы не передадите <tt>false</tt> вторым аргументом.
     </dd>
     <dd>отключено по умолчанию.</dd>
@@ -2266,7 +2278,7 @@ set :protection, :session => true
     <dd>
       mime-типы, к которым метод <tt>content_type</tt> будет автоматически добавлять
       информацию о кодировке. Вам следует добавлять значения к этой опции
-      вместо ее переопределения: <tt>settings.add_charset << "application/foobar"</tt>
+      вместо её переопределения: <tt>settings.add_charset << "application/foobar"</tt>
     </dd>
   <dt>app_file</dt>
@@ -2279,7 +2291,7 @@ set :protection, :session => true
   <dt>bind</dt>
     <dd>
       используемый IP-адрес (по умолчанию: <tt>0.0.0.0</tt> <em>или</em>
-      <tt>localhost</tt> если ваша `environment` настроена на разработку).
+      <tt>localhost</tt> если опция `environment` настроена на "development").
     Используется только встроенным сервером.
     </dd>
@@ -2300,18 +2312,18 @@ set :protection, :session => true
   <dt>lock</dt>
     <dd>
-      создает блокировку для каждого запроса, которая гарантирует обработку
+      создаёт блокировку для каждого запроса, которая гарантирует обработку
       только одного запроса в текущий момент времени в Ruby процессе.
     </dd>
     <dd>
-      включайте, если ваше приложение не потоко-безопасно (thread-safe).
+      включайте в том случае, если ваше приложение не потокобезопасно (thread-safe).
       Отключено по умолчанию.
   </dd>
   <dt>method_override</dt>
     <dd>
-      использовать "магический" параметр <tt>_method</tt>, для поддержки
-      PUT/DELETE форм в браузерах, которые не поддерживают эти методы.
+      использовать "магический" параметр <tt>_method</tt> для поддержки
+      PUT/DELETE форм в браузерах, которые не поддерживают данные методы.
     </dd>
   <dt>mustermann_opts</dt>
@@ -2383,20 +2395,30 @@ set :protection, :session => true
   <dt>server</dt>
     <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>
   <dt>session_store</dt>
     <dd>
-      используется Rack "прослойка" сессии. По умолчанию <tt>Rack::Session::Cookie</tt>.
-    Смотрите секцию "Использование сессий" выше.
+      используемая Rack "прослойка" для сессии. По умолчанию <tt>Rack::Session::Cookie</tt>.
+      Смотрите раздел "Использование сессий" выше.
     </dd>
   <dt>show_exceptions</dt>
@@ -2406,19 +2428,19 @@ set :protection, :session => true
     </dd>
     <dd>
       может также быть установлено в <tt>:after_handler</tt> для запуска специфичной
-    для приложения обработки ошибок, перед показом трассировки стека в браузере.
+      для приложения обработки ошибок, перед показом трассировки стека в браузере.
     </dd>
   <dt>static</dt>
-    <dd>должна ли Sinatra осуществлять раздачу статических файлов.</dd>
-    <dd>Отключите, когда используете какой-либо веб-сервер для этой цели.</dd>
+    <dd>указывает, должна ли Sinatra осуществлять раздачу статических файлов.</dd>
+    <dd>Отключите, если используете какой-либо веб-сервер для этой цели.</dd>
     <dd>Отключение значительно улучшит производительность приложения.</dd>
     <dd>По умолчанию включено в классических и отключено в модульных приложениях.</dd>
   <dt>static_cache_control</dt>
     <dd>
-      когда Sinatra отдает статические файлы, используйте эту опцию, чтобы
-      добавить им заголовок <tt>Cache-Control</tt>. Для этого используется
+      когда Sinatra раздаёт статические файлы, используйте эту опцию для того,
+      чтобы добавить им заголовок <tt>Cache-Control</tt>. Для этого используется
       метод-помощник <tt>cache_control</tt>. По умолчанию отключено.
     </dd>
     <dd>
@@ -2433,38 +2455,38 @@ set :protection, :session => true
     </dd>
   <dt>traps</dt>
-    <dd>должна ли Sinatra обрабатывать системные сигналы или нет.</tt></dd>
+    <dd>указывает, должна ли Sinatra обрабатывать системные сигналы.</tt></dd>
   <dt>views</dt>
     <dd>
-    путь к директории с шаблонами. Берётся из настройки <tt>app_file</tt>,
-    если не установлен.
+    путь к директории с шаблонами. Берётся из настройки <tt>app_file</tt> в том
+    случае, если не установлен.
     </dd>
   <dt>x_cascade</dt>
     <dd>
-      Установлен ли заголовок X-Cascade если никакие маршруты не совпадают.
+      Указывает, необходимо ли устанавливать заголовок X-Cascade если никакие маршруты не совпадают.
       <tt>true</tt> по умолчанию.
     </dd>
 </dl>
 ## Режим, окружение
-Есть 3 предопределенных режима, окружения: `"development"`, `"production"` и
-`"test"`. Режим может быть задан через переменную окружения `APP_ENV`.
+Есть 3 предопределённых режима работы приложения (окружения): `"development"`,
+`"production"` и `"test"`. Режим может быть задан через переменную окружения `APP_ENV`.
 Значение по умолчанию — `"development"`. В этом режиме работы все шаблоны
-перезагружаются между запросами. А также задаются специальные обработчики
+перезагружаются между запросами, а также задаются специальные обработчики
 `not_found` и `error`, чтобы вы могли увидеть стек вызовов. В окружениях
 `"production"` и `"test"` шаблоны по умолчанию кэшируются.
-Для запуска приложения в определенном окружении установите переменную
+Для запуска приложения в определённом окружении установите переменную
 окружения `APP_ENV`:
 ```shell
 APP_ENV=production ruby my_app.rb
 ```
-Вы можете использовать предопределенные методы `development?`, `test?` и
+Вы можете использовать предопределённые методы `development?`, `test?` и
 `production?`, чтобы определить текущее окружение.
 ```ruby
@@ -2479,14 +2501,14 @@ end
 ## Обработка ошибок
-Обработчики ошибок исполняются в том же контексте, что и маршруты, и
+Обработчики ошибок исполняются в том же контексте, что и маршруты и
 `before`-фильтры, а это означает, что всякие прелести вроде `haml`, `erb`,
 `halt` и т.д. доступны и им.
 ### Not Found
-Когда выброшено исключение `Sinatra::NotFound`, или кодом ответа является 404,
-то будет вызван `not_found` обработчик:
+В случае возникновения исключения `Sinatra::NotFound` или возврата кода ответа 404
+будет вызван обработчик `not_found`:
 ```ruby
 not_found do
@@ -2496,9 +2518,9 @@ end
 ### Error
-Обработчик ошибок `error` будет вызван, когда исключение выброшено из блока
-маршрута, либо из фильтра. Но заметьте, что в режиме разработки он будет
-запускаться, только если вы установите опцию "show exceptions"
+Обработчик ошибок `error` будет вызван тогда, когда исключение выброшено из блока
+маршрута либо из фильтра. Тем не менее, обратите внимание на то, что в режиме разработки
+он будет запускаться только в том случае, если вы установите опцию "show exceptions"
 на `: after_handler`:
 ```ruby
@@ -2513,7 +2535,7 @@ error do
 end
 ```
-Конкретные ошибки:
+Пользовательские ошибки:
 ```ruby
 error MyCustomError do
@@ -2521,7 +2543,7 @@ error MyCustomError do
 end
 ```
-Тогда, если это произошло:
+Тогда, если это возникнет:
 ```ruby
 get '/' do
@@ -2555,21 +2577,22 @@ error 400..510 do
 end
 ```
-Sinatra устанавливает специальные `not_found` и `error` обработчики, когда
+Sinatra устанавливает специальные обработчики `not_found` и `error`, когда
 приложение запущено в режиме разработки (окружение `:development`) чтобы
-отображать хорошие трассировки стека и дополнительную информацию об отладке
+отображать информативные трассировки стека и дополнительную информацию об отладке
 в вашем браузере.
-## Rack "прослойка"
+## 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'
@@ -2585,7 +2608,7 @@ end
 Семантика `use` идентична той, что определена для
 [Rack::Builder](http://www.rubydoc.info/github/rack/rack/master/Rack/Builder) DSL
-(чаще всего используется в rackup файлах). Например, метод `use` принимает как
+(чаще всего используется в rackup файлах). Так, например, метод `use` принимает как
 множественные переменные, так и блоки:
 ```ruby
@@ -2597,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'
@@ -2642,7 +2663,7 @@ end
 ```
 Примечание: если вы используете Sinatra в модульном стиле, замените
-`Sinatra::Application` в примере выше выше на имя класса вашего приложения.
+`Sinatra::Application` в примере выше на имя класса вашего приложения.
 ## Sinatra::Base — "прослойки", библиотеки и модульные приложения
@@ -2651,7 +2672,7 @@ end
 Rack "прослойка", Rails metal, простые библиотеки с серверным компонентом или
 даже расширения Sinatra. Верхний уровень предполагает конфигурацию стиля
 микроприложений (например, одиночный файл приложения, `./public` и `./views`,
-каталоги, логгирование, страницу подробных сведений об исключениях и т.д.).
+каталоги, логирование, страницу подробных сведений об исключениях и т.д.).
 И тут на помощь приходит `Sinatra::Base`:
 ```ruby
@@ -2667,13 +2688,13 @@ class MyApp < Sinatra::Base
 end
 ```
-Методы, доступные `Sinatra::Base` подклассам идентичны тем, что доступны
-приложениям в DSL верхнего уровня. Большинство таких приложений могут быть
-конвертированы в `Sinatra::Base` компоненты с помощью двух модификаций:
+Методы, доступные подклассам `Sinatra::Base` идентичны тем, что доступны
+приложениям при помощи DSL верхнего уровня. Большинство таких приложений могут быть
+конвертированы в `Sinatra::Base` компоненты при помощи двух модификаций:
 * Вы должны подключать `sinatra/base` вместо `sinatra`, иначе все DSL методы,
   предоставляемые Sinatra, будут импортированы в глобальное пространство
-  имен.
+  имён.
 * Поместите все маршруты, обработчики ошибок, фильтры и опции в подкласс
   `Sinatra::Base`.
@@ -2681,9 +2702,9 @@ end
 сервер, по умолчанию отключены. Смотрите
 [Опции и конфигурация](http://www.sinatrarb.com/configuration.html)
 для детальной информации об опциях и их поведении. Если вы хотите, чтобы
-поведение было более похоже на то, когда вы определяете свое приложение
+поведение было более похоже на то, когда вы определяете своё приложение
 на верхнем уровне (также известно как классический стиль), вы можете
-подклассифицировать `Sinatra::Application`:
+унаследоваться от `Sinatra::Application`:
 ```ruby
 require 'sinatra/base'
@@ -2763,7 +2784,7 @@ end
 ### Запуск модульных приложений
 Есть два общепринятых способа запускать модульные приложения: запуск напрямую
-с помощью `run!`:
+при помощи `run!`:
 ```ruby
 # my_app.rb
@@ -2783,11 +2804,11 @@ end
 ruby my_app.rb
 ```
-Или с помощью конфигурационного файла `config.ru`, который позволяет
-использовать любой Rack-совместимый сервер приложений.
+Или при помощи конфигурационного файла `config.ru`, который позволяет
+использовать любой Rack-совместимый сервер приложений:
 ```ruby
-# config.ru (запускается с помощью Rackup)
+# config.ru (запускается при помощи Rackup)
 require './my_app'
 run MyApp
 ```
@@ -2820,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 в качестве "прослойки"
@@ -2838,7 +2858,7 @@ run Sinatra::Application
 Не только сама Sinatra может использовать "прослойки" Rack, но и любое Sinatra
 приложение само может быть добавлено к любому Rack endpoint в качестве
 "прослойки". Этим endpoint (конечной точкой) может быть другое Sinatra
-приложение, или приложение, основанное на Rack (Rails/Hamami/Roda/...):
+приложение или любое другое приложение, основанное на Rack (Rails/Hamami/Roda/...):
 ```ruby
 require 'sinatra/base'
@@ -2874,7 +2894,7 @@ end
 ### Создание приложений "на лету"
 Иногда требуется создавать Sinatra приложения "на лету" (например, из другого
-приложения). Это возможно с помощью `Sinatra.new`:
+приложения), не сохраняя их в константу. Это возможно при помощи `Sinatra.new`:
 ```ruby
 require 'sinatra/base'
@@ -2886,7 +2906,7 @@ my_app.run!
 наследоваться:
 ```ruby
-# config.ru (запускается с помощью Rackup)
+# config.ru (запускается при помощи Rackup)
 require 'sinatra/base'
 controller = Sinatra.new do
@@ -2906,7 +2926,7 @@ end
 Это особенно полезно для тестирования расширений Sinatra и при использовании
 Sinatra внутри вашей библиотеки.
-Благодаря этому, использовать Sinatra как "прослойку" очень просто:
+Это также значительно упрощает использование Sinatra в качестве прослойки:
 ```ruby
 require 'sinatra/base'
@@ -2932,7 +2952,7 @@ run RailsProject::Application
 вы не сможете получить доступ к объектам `request` или `session`, так как
 существует только один класс приложения для всех запросов.
-Опции, созданные с помощью `set`, являются методами уровня класса:
+Опции, созданные при помощи `set`, являются методами уровня класса:
 ```ruby
 class MyApp < Sinatra::Base
@@ -2946,10 +2966,10 @@ class MyApp < Sinatra::Base
 end
 ```
-У вас будет область видимости приложения внутри:
+У вас будет привязка к области видимости приложения внутри:
 * тела вашего класса приложения;
-* методов, определенных расширениями;
+* методов, определённых расширениями;
 * блока, переданного в `helpers`;
 * блоков, использованных как значения для `set`;
 * блока, переданного в `Sinatra.new`.
@@ -2964,9 +2984,9 @@ end
 Для каждого входящего запроса будет создан новый экземпляр вашего приложения,
 и все блоки обработчика будут запущены в этом контексте. В этой области
-видимости вам доступны `request` и `session` объекты, вызовы методов
+видимости вам доступны `request` и `session` объекты, а также вызовы методов
 рендеринга, такие как `erb` или `haml`. Вы можете получить доступ к области
-видимости приложения из контекста запроса, используя метод-помощник
+видимости приложения из контекста запроса используя метод-помощник
 `settings`:
 ```ruby
@@ -2986,7 +3006,7 @@ class MyApp < Sinatra::Base
 end
 ```
-У вас будет область видимости запроса в:
+У вас будет привязка к области видимости запроса в:
 * get, head, post, put, delete, options, patch, link и unlink блоках;
 * before и after фильтрах;
@@ -3006,7 +3026,7 @@ end
 У вас будет контекст делегирования внутри:
 *  привязки верхнего уровня, если вы сделали `require "sinatra"`;
-*  объекта, расширенного с помощью `Sinatra::Delegator`.
+*  объекта, расширенного при помощи `Sinatra::Delegator`.
 Посмотрите сами в код: вот
 [примесь Sinatra::Delegator](https://github.com/sinatra/sinatra/blob/ca06364/lib/sinatra/base.rb#L1609-1633)
@@ -3020,7 +3040,7 @@ Sinatra приложения могут быть запущены напряму
 ruby myapp.rb [-h] [-x] [-q] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
 ```
-Опции включают:
+Поддерживаемые опции:
 ```
 -h # раздел помощи
@@ -3032,16 +3052,16 @@ ruby myapp.rb [-h] [-x] [-q] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
 -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
@@ -3059,45 +3079,42 @@ App.run!
 ```
-Чтобы запустить сервер, вы должны выполнить следующую команду:
+Для запуска сервере выполните следующую команду:
 ```shell
 thin --threaded start
 ```
-[so-answer]: http://stackoverflow.com/questions/6278817/is-sinatra-multi-threaded/6282999#6282999)
 ## Системные требования
 Следующие версии Ruby официально поддерживаются:
 <dl>
   <dt>Ruby 2.2</dt>
   <dd>
-    2.2 полностью поддерживается и рекомендуется. В настоящее время нет
+    Версия 2.2 полностью поддерживается и рекомендуется. В настоящее время нет
   планов отказаться от официальной поддержки.
   </dd>
   <dt>Rubinius</dt>
   <dd>
     Rubinius официально поддерживается (Rubinius >= 2.x). Рекомендуется
-  выполнить <tt>gem install puma</tt>.
+    выполнить <tt>gem install puma</tt>.
   </dd>
   <dt>JRuby</dt>
   <dd>
     Официально поддерживается последний стабильный релиз JRuby. Не
-  рекомендуется использовать расширений на C в JRuby. Рекомендуется
-  выполнить <tt>gem install trinidad</tt>.
+    рекомендуется использовать расширений на C в JRuby. Рекомендуется
+    выполнить <tt>gem install trinidad</tt>.
   </dd>
 </dl>
-Версии Ruby старше 2.2.2 больше не поддерживаются в Sinatra 2.0.
+Версии Ruby ниже 2.2.2 более не поддерживаются в Sinatra 2.0.
 Мы также следим за предстоящими к выходу версиями Ruby.
-Следующие реализации Ruby не поддерживаются официально, но известно, что на
-них запускается Sinatra:
+Следующие реализации Ruby не поддерживаются официально, однако известно, что
+на них запускается Sinatra:
 * старые версии JRuby и Rubinius;
 * Ruby Enterprise Edition;
@@ -3118,28 +3135,28 @@ Sinatra должна работать на любой операционной
 Если вы запускаете MacRuby, вы должны выполнить `gem install control_tower`.
 Пока невозможно запустить Sinatra на Cardinal, SmallRuby, BlueRuby и на любой
-версии Ruby старше 2.2.
+версии 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
@@ -3152,14 +3169,14 @@ source 'https://rubygems.org'
 gem 'sinatra', :github => 'sinatra/sinatra'
 # другие зависимости
-gem 'haml'                    # например, если используете haml
+gem 'haml'                    # в том случае, если используете haml
 ```
-Обратите внимание, вам нужно будет указывать все зависимости вашего приложения
-в `Gemfile`. Однако, непосредственные зависимости Sinatra (Rack и Tilt)
-Bundler автоматически скачает и добавит.
+Имейте ввиду, что вам необходимо будет указывать все зависимости вашего приложения
+в `Gemfile`. Необходимые зависимости самой библиотеки Sinatra (Rack и Tilt)
+будут автоматически скачаны и добавлены Bundler.
-Теперь вы можете запускать свое приложение так:
+Теперь вы можете запускать своё приложение следующим образом:
 ```shell
 bundle exec ruby myapp.rb
@@ -3167,7 +3184,7 @@ bundle exec ruby myapp.rb
 ## Версии
-Sinatra использует [Semantic Versioning](http://semver.org/), SemVer и
+Sinatra использует [Semantic Versioning](https://semver.org/): как SemVer, так и
 SemVerTag.
 ## Дальнейшее чтение
@@ -3178,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) на