sinatra 1.3.0.a → 1.3.0.b

data/README.rdoc

@@ -1099,29 +1099,33 @@ error handlers) through the <tt>request</tt> method:
 
   # app running on http://example.com/example
   get '/foo' do
-    request.body              # request body sent by the client (see below)
-    request.scheme            # "http"
-    request.script_name       # "/example"
-    request.path_info         # "/foo"
-    request.port              # 80
-    request.request_method    # "GET"
-    request.query_string      # ""
-    request.content_length    # length of request.body
-    request.media_type        # media type of request.body
-    request.host              # "example.com"
-    request.get?              # true (similar methods for other verbs)
-    request.form_data?        # false
-    request["SOME_HEADER"]    # value of SOME_HEADER header
-    request.referrer          # the referrer of the client or '/'
-    request.user_agent        # user agent (used by :agent condition)
-    request.cookies           # hash of browser cookies
-    request.xhr?              # is this an ajax request?
-    request.url               # "http://example.com/example/foo"
-    request.path              # "/example/foo"
-    request.ip                # client IP address
-    request.secure?           # false (would be true over ssl)
-    request.forwarded?        # true (if running behind a reverse proxy)
-    request.env               # raw env hash handed in by Rack
+    t = %w[text/css text/html application/javascript]
+    request.accept              # ['text/html', '*/*']
+    request.accept? 'text/xml'  # true
+    request.preferred_type(t)   # 'text/html'
+    request.body                # request body sent by the client (see below)
+    request.scheme              # "http"
+    request.script_name         # "/example"
+    request.path_info           # "/foo"
+    request.port                # 80
+    request.request_method      # "GET"
+    request.query_string        # ""
+    request.content_length      # length of request.body
+    request.media_type          # media type of request.body
+    request.host                # "example.com"
+    request.get?                # true (similar methods for other verbs)
+    request.form_data?          # false
+    request["SOME_HEADER"]      # value of SOME_HEADER header
+    request.referrer            # the referrer of the client or '/'
+    request.user_agent          # user agent (used by :agent condition)
+    request.cookies             # hash of browser cookies
+    request.xhr?                # is this an ajax request?
+    request.url                 # "http://example.com/example/foo"
+    request.path                # "/example/foo"
+    request.ip                  # client IP address
+    request.secure?             # false (would be true over ssl)
+    request.forwarded?          # true (if running behind a reverse proxy)
+    request.env                 # raw env hash handed in by Rack
   end
 
 Some options, like <tt>script_name</tt> or <tt>path_info</tt>, can also be
@@ -1615,6 +1619,45 @@ application (Rails/Ramaze/Camping/...):
     get('/') { "Hello #{session['user_name']}." }
   end
 
+=== Dynamic Application Creation
+
+Sometimes you want to create new applications at runtime without having to
+assign them to a constant, you can do this with `Sinatra.new`:
+
+  require 'sinatra/base'
+  my_app = Sinatra.new { get('/') { "hi" } }
+  my_app.run!
+
+It takes the application to inherit from as optional argument:
+
+  require 'sinatra/base'
+
+  controller = Sinatra.new do
+    enable :logging
+    helpers MyHelpers
+  end
+
+  map('/a') do
+    run Sinatra.new(controller) { get('/') { 'a' } }
+  end
+
+  map('/b') do
+    run Sinatra.new(controller) { get('/') { 'b' } }
+  end
+
+This is especially useful for testing Sinatra extensions or using Sinatra in
+your own library.
+
+This also makes using Sinatra as middleware extremely easy:
+
+  require 'sinatra/base'
+
+  use Sinatra do
+    get('/') { ... }
+  end
+
+  run RailsProject::Application
+
 == Scopes and Binding
 
 The scope you are currently in determines what methods and variables are
@@ -1647,6 +1690,7 @@ You have the application scope binding inside:
 * Methods defined by extensions
 * The block passed to +helpers+
 * Procs/blocks used as value for +set+
+* The block passed to <tt>Sinatra.new</tt>
 
 You can reach the scope object (the class) like this:
 

data/README.ru.rdoc

@@ -1,8 +1,7 @@
 = Sinatra
 <i>Внимание: Этот документ является переводом Английской версии и может быть устаревшим</i>
 
-Sinatra — это предметно-ориентированный язык (DSL) для быстрого создания приложений на Ruby с
-приложением минимума усилий:
+Sinatra — это предметно-ориентированный каркас (DSL) для быстрого создания функциональных веб-приложений на Ruby:
 
   # myapp.rb
   require 'sinatra'
@@ -11,20 +10,23 @@ Sinatra — это предметно-ориентированный язык (D
     'Hello world!'
   end
 
-Установите gem и запустите приложение с помощью:
+Установите gem:
 
   gem install sinatra
+
+и запустите приложение с помощью:
+
   ruby -rubygems myapp.rb
 
-Результат будет тут: http://localhost:4567
+Результат можно увидеть: http://localhost:4567
 
-Рекомендуется также запустить <tt>gem install thin</tt>, чтобы Sinatra
-могла использовать thin в качестве сервера.
+Рекомендуется также установить thin, сделать это можно командой: <tt>gem install thin</tt>.
+Thin - это более производительный и функциональный сервер для разработки приложений на Sinatra.
 
 == Маршруты
 
-В Sinatra маршрут — это пара: HTTP метод и шаблон (образец) URL.
-Каждый маршрут ассоциирован с блоком:
+В Sinatra маршрут — это пара: <HTTP метод> и <шаблон URL>.
+Каждый маршрут ассоциирован с блоком кода, исполняемого внутри, пример:
 
   get '/' do
     .. что-то показать ..
@@ -50,7 +52,7 @@ Sinatra — это предметно-ориентированный язык (D
     .. что-то ответить ..
   end
 
-Маршруты сверяются с запросом по очередности определения. Первый же совпавший с запросом маршрут и будет вызван.
+Маршруты сверяются с запросом в порядке очередности их записи в файле приложения. По умолчанию, будет вызван первый совпавший с запросом маршрут.
 
 Шаблоны маршрутов могут включать в себя параметры доступные в
 <tt>params</tt> xэше:
@@ -67,8 +69,8 @@ Sinatra — это предметно-ориентированный язык (D
     "Hello #{n}!"
   end
 
-Шаблоны маршрутов также могут включать splat (wildcard, *, любая строка символов) параметры доступные
-в <tt>params[:splat]</tt> массиве:
+Шаблоны маршрутов также могут включать splat (или '*' маску, обозначающую любой символ) параметры доступные
+в массиве <tt>params[:splat]</tt>:
 
   get '/say/*/to/*' do
     # соответствует /say/hello/to/world
@@ -80,7 +82,7 @@ Sinatra — это предметно-ориентированный язык (D
     params[:splat] # => ["path/to/file", "xml"]
   end
 
-Маршруты также могут использовать регулярные выражения в качестве шаблона URL:
+Маршруты также могут содержать регулярные выражения:
 
   get %r{/hello/([\w]+)} do
     "Hello, #{params[:captures].first}!"
@@ -118,7 +120,7 @@ Sinatra — это предметно-ориентированный язык (D
     builder :feed
   end
 
-Довольно легко можно задать собственные условия:
+Вы можете задать собственные условия:
 
   set(:probability) { |value| condition { rand <= value } }
   
@@ -133,18 +135,17 @@ Sinatra — это предметно-ориентированный язык (D
 === Возвращаемые значения
 
 Возвращаемое значение блока маршрута ограничивается телом ответа, которое будет передано HTTP клиенту,
-или следующей "прослойкой" (middleware, промежуточная программа) в Rack стеке. Чаще всего это строка, как в вышеизложенных примерах.
+или следующей "прослойкой" (middleware) в Rack стеке. Чаще всего это строка, как в примерах выше.
 Но и другие значения также приемлемы.
 
-Вы можете вернуть любой объект, который будет либо корректным Rack ответом, Rack
-телом ответа, либо кодом состояния HTTP:
+Вы можете вернуть любой объект, который будет либо корректным Rack ответом, объектом Rack body, либо кодом состояния HTTP:
 
-* Массив с тремя переменными: <tt>[status (Fixnum), headers (Hash), response body (должен отвечать на #each)]</tt>
-* Массив с двумя переменными: <tt>[status (Fixnum), response body (должен отвечать на #each)]</tt>
-* Объект, отвечающий на <tt>#each</tt>, который передает только строковые типы данных в этот блок
-* Fixnum, соответствующий коду состояния HTTP
+* массив с тремя переменными: <tt>[status (Fixnum), headers (Hash), response body (должен отвечать на #each)]</tt>;
+* массив с двумя переменными: <tt>[status (Fixnum), response body (должен отвечать на #each)]</tt>;
+* объект, отвечающий на <tt>#each</tt>, который передает только строковые типы данных в этот блок;
+* Fixnum, представляющий код состояния HTTP.
 
-Таким образом мы легко можем создать поточный пример:
+Таким образом, мы легко можем создать поточный пример:
 
     class Stream
       def each
@@ -157,7 +158,7 @@ Sinatra — это предметно-ориентированный язык (D
 === Собственные детекторы совпадений для маршрутов
 
 Как показано выше, Sinatra поставляется со встроенной поддержкой строк и
-регулярных выражений как шаблонов URL. Но и это еще не все. Вы можете
+регулярных выражений в качестве шаблонов URL. Но и это еще не все. Вы можете
 легко определить свои собственные детекторы совпадений (matchers) для маршрутов:
 
   class AllButPattern
@@ -181,8 +182,7 @@ Sinatra — это предметно-ориентированный язык (D
     # ...
   end
 
-Заметьте, что предыдущий пример довольно переусложнен, ведь он также может
-быть записан в следующем виде:
+Заметьте, что предыдущий пример возможно чересчур сложен, он также может быть представлен как:
 
   get // do
     pass if request.path_info == "/index"
@@ -198,7 +198,7 @@ Sinatra — это предметно-ориентированный язык (D
 == Статические файлы
 
 Статические файлы отдаются из <tt>./public</tt> директории. Вы можете указать другое место,
-используя <tt>:public</tt> опцию:
+указав его через опцию <tt>:public</tt>:
 
   set :public, File.dirname(__FILE__) + '/static'
 
@@ -206,17 +206,17 @@ Sinatra — это предметно-ориентированный язык (D
 <tt>./public/css/style.css</tt> будет доступен как
 <tt>http://example.com/css/style.css</tt>.
 
-== Виды / Шаблоны
+== Представления / Шаблоны
 
-Шаблоны по умолчанию будут использованы из директории <tt>./views</tt>.
-Для использования другой директории:
+Шаблоны по умолчанию должны находиться в директории <tt>./views</tt>.
+Для использования другой директории шаблонов:
 
   set :views, File.dirname(__FILE__) + '/templates'
 
 Важно помнить, что вы всегда должны указывать шаблоны
 с помощью символов, даже если это подкаталог (в этом случае
 используйте <tt>:'subdir/template'</tt>). Вы должны использовать
-символ, иначе методы, ответственные за рендеринг, отобразят просто переданную им строку.
+символ, иначе методы рендеринга, отобразят просто переданную им строку.
 
 === Haml шаблоны
 
@@ -229,7 +229,7 @@ Sinatra — это предметно-ориентированный язык (D
     haml :index
   end
 
-Отрисует <tt>./views/index.haml</tt>.
+Отобразит <tt>./views/index.haml</tt>.
 
 {Опции Haml}[http://haml-lang.com/docs/yardoc/file.HAML_REFERENCE.html#options]
 могут быть установлены глобально через конфигурацию Sinatra,
@@ -252,7 +252,7 @@ Sinatra — это предметно-ориентированный язык (D
     erb :index
   end
 
-Отрисует <tt>./views/index.erb</tt>.
+Отобразит <tt>./views/index.erb</tt>.
 
 === Erubis шаблоны
 
@@ -265,7 +265,7 @@ Sinatra — это предметно-ориентированный язык (D
     erubis :index
   end
 
-Отрисует <tt>./views/index.erubis</tt>.
+Отобразит <tt>./views/index.erubis</tt>.
 
 Также возможно заменить Erb на Erubis:
 
@@ -276,7 +276,7 @@ Sinatra — это предметно-ориентированный язык (D
     erb :index
   end
 
-Отрисует <tt>./views/index.erb</tt> с помощью Erubis.
+Отобразит <tt>./views/index.erb</tt> с помощью Erubis.
 
 === Builder шаблоны
 
@@ -289,7 +289,7 @@ Sinatra — это предметно-ориентированный язык (D
     builder :index
   end
 
-Отрисует <tt>./views/index.builder</tt>.
+Отобразит <tt>./views/index.builder</tt>.
 
 === Nokogiri шаблоны
 
@@ -302,7 +302,7 @@ Sinatra — это предметно-ориентированный язык (D
     nokogiri :index
   end
 
-Отрисует <tt>./views/index.nokogiri</tt>.
+Отобразит <tt>./views/index.nokogiri</tt>.
 
 === Sass шаблоны
 
@@ -315,7 +315,7 @@ Sinatra — это предметно-ориентированный язык (D
     sass :stylesheet
   end
 
-Отрисует <tt>./views/stylesheet.sass</tt>.
+Отобразит <tt>./views/stylesheet.sass</tt>.
 
 {Опции Sass}[http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options]
 могут быть установлены глобально через конфигурацию Sinatra,
@@ -339,7 +339,7 @@ Sinatra — это предметно-ориентированный язык (D
     scss :stylesheet
   end
 
-Отрисует <tt>./views/stylesheet.scss</tt>.
+Отобразит <tt>./views/stylesheet.scss</tt>.
 
 {Опции Scss}[http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options]
 могут быть установлены глобально через конфигурацию Sinatra,
@@ -363,7 +363,7 @@ Sinatra — это предметно-ориентированный язык (D
     less :stylesheet
   end
 
-Отрисует <tt>./views/stylesheet.less</tt>.
+Отобразит <tt>./views/stylesheet.less</tt>.
 
 === Liquid шаблоны
 
@@ -376,7 +376,7 @@ Sinatra — это предметно-ориентированный язык (D
     liquid :index
   end
 
-Отрисует <tt>./views/index.liquid</tt>.
+Отобразит <tt>./views/index.liquid</tt>.
 
 Так как в Liquid шаблонах невозможно вызывать методы из Ruby (кроме +yield+),
 то вы почти всегда будете передавать локальные переменные:
@@ -388,13 +388,13 @@ Sinatra — это предметно-ориентированный язык (D
 <tt>rdiscount</tt> gem/библиотека необходима для рендеринга Markdown шаблонов:
 
   # Вам нужно будет подключить rdiscount в приложении
-  require "rdiscount"
+  require 'rdiscount'
   
   get '/' do
     markdown :index
   end
 
-Отрисует <tt>./views/index.markdown</tt> (+md+ и +mkd+ также являются допустимыми файловыми
+Отобразит <tt>./views/index.markdown</tt> (+md+ и +mkd+ также являются допустимыми файловыми
 расширениями).
 
 В Markdown невозможно вызывать методы или передавать локальные переменные.
@@ -410,14 +410,14 @@ Sinatra — это предметно-ориентированный язык (D
 
 Вы не можете вызывать Ruby из Markdown, соответственно, вы не можете использовать
 лэйаут-шаблоны (layouts) на Markdown. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута с помощью опции <tt>:layout_engine</tt>:
+движок рендеринга для шаблона, а другой для лэйаута (разметки) с помощью опции <tt>:layout_engine</tt>:
 
   get '/' do
     markdown :index, :layout_engine => :erb
   end
 
-Отрисует <tt>./views/index.md</tt> с <tt>./views/layout.erb</tt> в качестве
-лэйаута.
+Отобразит <tt>./views/index.md</tt> с <tt>./views/layout.erb</tt> в качестве
+лэйаута (разметки).
 
 Также вы можете задать такие опции рендеринга глобально:
 
@@ -427,8 +427,8 @@ Sinatra — это предметно-ориентированный язык (D
     markdown :index
   end
 
-Отрисует <tt>./views/index.md</tt> (и любой другой шаблон на Markdown) с
-<tt>./views/post.haml</tt> в качестве лэйаута.
+Отобразит <tt>./views/index.md</tt> (и любой другой шаблон на Markdown) с
+<tt>./views/post.haml</tt> в качестве лэйаута (разметки).
 
 Также возможно обрабатывать Markdown с помощью BlueCloth, а не RDiscount:
 
@@ -442,20 +442,20 @@ Sinatra — это предметно-ориентированный язык (D
     markdown :index
   end
 
-Отрисует <tt>./views/index.md</tt> с помощью BlueCloth.
+Отобразит <tt>./views/index.md</tt> с помощью BlueCloth.
 
 === Textile шаблоны
 
 <tt>RedCloth</tt> gem/библиотека необходима для рендеринга Textile шаблонов:
 
   # Вам нужно будет подключить redcloth в приложении
-  require "redcloth"
+  require 'redcloth'
 
   get '/' do
     textile :index
   end
 
-Отрисует <tt>./views/index.textile</tt>.
+Отобразит <tt>./views/index.textile</tt>.
 
 В Textile невозможно вызывать методы или передавать локальные переменные. Следовательно, вам, скорее всего,
 придется использовать этот шаблон совместно с другим движком рендеринга:
@@ -469,14 +469,14 @@ Sinatra — это предметно-ориентированный язык (D
 
 Вы не можете вызывать Ruby из Textile, соответственно, вы не можете использовать
 лэйаут-шаблоны на Textile. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута с помощью опции <tt>:layout_engine</tt>:
+движок рендеринга для шаблона, а другой для лэйаута (разметки) с помощью опции <tt>:layout_engine</tt>:
 
   get '/' do
     textile :index, :layout_engine => :erb
   end
 
-Отрисует <tt>./views/index.textile</tt> с <tt>./views/layout.erb</tt> в качестве
-лэйаута.
+Отобразит <tt>./views/index.textile</tt> с <tt>./views/layout.erb</tt> в качестве
+лэйаута (разметки).
 
 Также вы можете задать такие опции рендеринга глобально:
 
@@ -486,21 +486,21 @@ Sinatra — это предметно-ориентированный язык (D
     textile :index
   end
 
-Отрисует <tt>./views/index.textile</tt> (и любой другой шаблон на Textile) с
-<tt>./views/post.haml</tt> в качестве лэйаута.
+Отобразит <tt>./views/index.textile</tt> (и любой другой шаблон на Textile) с
+<tt>./views/post.haml</tt> в качестве лэйаута (разметки).
 
 === RDoc шаблоны
 
 <tt>rdoc</tt> gem/библиотека необходима для рендеринга RDoc шаблонов:
 
   # Вам нужно будет подключить rdoc/markup/to_html в приложении
-  require "rdoc/markup/to_html"
+  require 'rdoc/markup/to_html'
 
   get '/' do
     rdoc :index
   end
 
-Отрисует <tt>./views/index.rdoc</tt>.
+Отобразит <tt>./views/index.rdoc</tt>.
 
 В RDoc невозможно вызывать методы или передавать локальные переменные. Следовательно, вам, скорее всего,
 придется использовать этот шаблон совместно с другим движком рендеринга:
@@ -514,14 +514,14 @@ Sinatra — это предметно-ориентированный язык (D
 
 Вы не можете вызывать Ruby из RDoc, соответственно, вы не можете использовать
 лэйаут-шаблоны на RDoc. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута с помощью опции <tt>:layout_engine</tt>:
+движок рендеринга для шаблона, а другой для лэйаута (разметки) с помощью опции <tt>:layout_engine</tt>:
 
   get '/' do
     rdoc :index, :layout_engine => :erb
   end
 
-Отрисует <tt>./views/index.rdoc</tt> с <tt>./views/layout.erb</tt> в качестве
-лэйаута.
+Отобразит <tt>./views/index.rdoc</tt> с <tt>./views/layout.erb</tt> в качестве
+лэйаута (разметки).
 
 Также вы можете задать такие опции рендеринга глобально:
 
@@ -531,8 +531,8 @@ Sinatra — это предметно-ориентированный язык (D
     rdoc :index
   end
 
-Отрисует <tt>./views/index.rdoc</tt> (и любой другой шаблон на RDoc) с
-<tt>./views/post.haml</tt> в качестве лэйаута.
+Отобразит <tt>./views/index.rdoc</tt> (и любой другой шаблон на RDoc) с
+<tt>./views/post.haml</tt> в качестве лэйаута (разметки).
 
 === Radius шаблоны
 
@@ -545,7 +545,7 @@ Sinatra — это предметно-ориентированный язык (D
     radius :index
   end
 
-Отрисует <tt>./views/index.radius</tt>.
+Отобразит <tt>./views/index.radius</tt>.
 
 Так как в Radius шаблоне невозможно вызывать методы из Ruby (кроме +yield+), 
 то вы почти всегда будете передавать локальные переменные:
@@ -563,7 +563,7 @@ Sinatra — это предметно-ориентированный язык (D
     markaby :index
   end
 
-Отрисует <tt>./views/index.mab</tt>.
+Отобразит <tt>./views/index.mab</tt>.
 
 Вы также можете использовать внутристроковые Markaby шаблоны:
 
@@ -582,29 +582,29 @@ Sinatra — это предметно-ориентированный язык (D
     slim :index
   end
 
-Отрисует <tt>./views/index.slim</tt>.
+Отобразит <tt>./views/index.slim</tt>.
 
 === CoffeeScript шаблоны
 
 Вам понадобится <tt>coffee-script</tt> gem/библиотека и что-то <b>одно</b> из следующего списка,
 чтобы запускать JavaScript:
 
-* +node+ (из Node.js)
-* вы можете использовать OSX (есть встроенные средства для выполнения JavaScript)
-* +therubyracer+ gem/библиотека
+* +node+ (из Node.js);
+* вы можете использовать OS X (в которой есть встроенные средства для выполнения JavaScript);
+* +therubyracer+ gem/библиотека.
 
 Подробнее смотрите на {странице проекта}[http://github.com/josh/ruby-coffee-script].
 
-Таким образом вы можете использовать CoffeeScript шаблоны.
+Таким образом, вы можете использовать CoffeeScript шаблоны.
 
-  # Вам нужно будет подключить coffee-script в приложении
+  # Вам нужно будет подключить coffee-script gem в приложении
   require 'coffee-script'
 
   get '/application.js' do
     coffee :application
   end
 
-Отрисует <tt>./views/application.coffee</tt>.
+Отобразит <tt>./views/application.coffee</tt>.
 
 === Встроенные шаблоны
 
@@ -612,7 +612,7 @@ Sinatra — это предметно-ориентированный язык (D
     haml '%div.title Hello World'
   end
 
-Отрисует встроенный (строчный) шаблон.
+Отобразит строку встроенного шаблона.
 
 === Доступ к переменным в шаблонах
 
@@ -631,11 +631,11 @@ Sinatra — это предметно-ориентированный язык (D
     haml '%h1= foo.name', :locals => { :foo => foo }
   end
 
-Это обычный подход, когда шаблоны рендерятся как частные (partials) из других шаблонов.
+Это обычный подход, когда шаблоны рендерятся как части других шаблонов.
 
 === Вложенные шаблоны
 
-Шаблоны также могут быть определены в конце файла-исходника:
+Шаблоны также могут быть определены в конце исходного файла:
 
   require 'sinatra'
 
@@ -652,13 +652,13 @@ Sinatra — это предметно-ориентированный язык (D
   @@ index
   %div.title Hello world!!!!!
 
-Заметьте: вложенные шаблоны, определенные в файле-исходнике, который подключил Sinatra, будут
+Заметьте: вложенные шаблоны, определенные в исходном файле, который подключила Sinatra, будут
 автоматически загружены. Вызовите <tt>enable :inline_templates</tt> напрямую, если у вас вложенные
 шаблоны в других файлах.
 
 === Именные шаблоны
 
-Шаблоны также могут быть определены, используя <tt>template</tt> метод:
+Шаблоны также могут быть определены при помощи <tt>template</tt> метода:
 
   template :layout do
     "%html\n  =yield\n"
@@ -672,8 +672,8 @@ Sinatra — это предметно-ориентированный язык (D
     haml :index
   end
 
-Если шаблон с именем "layout" существует, то он будет использован каждый раз,
-когда шаблоны будут отрисовываться. Вы можете отключать лэйаут в каждом конкретном случае с помощью
+Если шаблон с именем "layout" существует, то он будет использоваться каждый раз
+при рендеринге. Вы можете отключать лэйаут (разметку) в каждом конкретном случае с помощью
 <tt>:layout => false</tt> или отключить его для всего приложения, например, так: <tt>set :haml, :layout => false</tt>:
 
   get '/' do
@@ -682,7 +682,7 @@ Sinatra — это предметно-ориентированный язык (D
 
 === Привязка файловых расширений
 
-Чтобы связать расширение файла и движок рендеринга, используйте
+Чтобы связать расширение файла с движком рендеринга, используйте
 <tt>Tilt.register</tt>. Например, если вы хотите использовать расширение +tt+
 для шаблонов Textile:
 
@@ -702,7 +702,7 @@ Sinatra — это предметно-ориентированный язык (D
     myat :index
   end
 
-Отрисует <tt>./views/index.myat</tt>. Чтобы узнать больше о Tilt,
+Отобразит <tt>./views/index.myat</tt>. Чтобы узнать больше о Tilt,
 смотрите https://github.com/rtomayko/tilt
 
 == Фильтры
@@ -729,9 +729,9 @@ Sinatra — это предметно-ориентированный язык (D
   end
 
 Заметьте: если вы используете метод +body+, а не просто возвращаете строку из
-маршрута, то тело ответа не будет доступно в +after+-фильтрах, потому что оно будет сгенерировано позднее.
+маршрута, то тело ответа не будет доступно в +after+-фильтрах, так как оно будет сгенерировано позднее.
 
-Фильтры могут использовать шаблоны URL и будут интерпретированы, только если путь запроса совпадет с этим шаблоном:
+Фильтры могут использовать шаблоны URL и будут интерпретированы только если путь запроса совпадет с этим шаблоном:
 
   before '/protected/*' do
     authenticate!
@@ -782,7 +782,7 @@ Sinatra — это предметно-ориентированный язык (D
   end
 
 Заметьте, что при использовании <tt>enable :sessions</tt> все данные
-сохраняются в куки. Это может быть не совсем то, что вы хотите (например,
+сохраняются в cookies. Это может быть не совсем то, что вы хотите (например,
 сохранение больших объемов данных увеличит ваш трафик). В таком случае вы
 можете использовать альтернативную Rack "прослойку" (middleware), реализующую
 механизм сессий. Для этого *не надо* вызывать <tt>enable :sessions</tt>,
@@ -806,8 +806,7 @@ Sinatra — это предметно-ориентированный язык (D
 
   set :session_secret, 'super secret'
 
-Если вы хотите больше настроек для сессий, вы можете задать их, используя
-хэш с опциями и параметр +sessions+:
+Если вы хотите больше настроек для сессий, вы можете задать их, передав хэш опций в параметр +sessions+:
 
   set :sessions, :domain => 'foo.com'
 
@@ -909,6 +908,29 @@ Sinatra — это предметно-ориентированный язык (D
 Как и +body+, методы +headers+ и +status+, вызванные без аргументов, возвращают
 свои текущие значения.
 
+=== Логирование
+
+В области видимости запроса метод +logger+ предоставляет доступ к экземпляру +Logger+:
+
+  get '/' do
+    logger.info "loading data"
+    # ...
+  end
+
+Этот логер автоматически учитывает ваши настройки логирования в Rack. Если
+логирование выключено, то этот метод вернет пустой (dummy) объект, поэтому вы можете
+смело использовать его в маршрутах и фильтрах.
+
+Заметьте, что логирование включено по умолчанию только для <tt>Sinatra::Application</tt>,
+а если ваше приложение -- подкласс <tt>Sinatra::Base</tt>, то вы, наверное, захотите включить
+его вручную:
+
+  class MyApp < Sinatra::Base
+    configure(:production, :development) do
+      enable :logging
+    end
+  end
+
 === Mime-типы
 
 Когда вы используете <tt>send_file</tt> или статические файлы, у вас могут быть mime-типы, которые Sinatra
@@ -916,7 +938,7 @@ Sinatra — это предметно-ориентированный язык (D
 
   mime_type :foo, 'text/foo'
 
-Вы также можете использовать это в +content_type+ помощнике:
+Вы также можете использовать это в +content_type+ методе-помощнике:
 
   get '/' do
     content_type :foo
@@ -1000,9 +1022,9 @@ Sinatra — это предметно-ориентированный язык (D
   end
 
 Чтобы как следует использовать кэши, вам следует подумать об использовании
-+etag+ и +last_modified+. Рекомендуется использовать эти методы *до*
++etag+ и +last_modified+. Рекомендуется использовать эти методы-помощники *до*
 выполнения "тяжелых" вычислений, так как они немедленно отправят ответ клиенту,
-если текущая версия уже есть в его кэше:
+если текущая версия уже есть в их кэше:
 
   get '/article/:id' do
     @article = Article.find params[:id]
@@ -1011,7 +1033,7 @@ Sinatra — это предметно-ориентированный язык (D
     erb :article
   end
 
-Так же вы можете использовать
+Также вы можете использовать
 {weak ETag}[http://en.wikipedia.org/wiki/HTTP_ETag#Strong_and_weak_validation]:
 
   etag @article.sha1, :weak
@@ -1020,8 +1042,8 @@ Sinatra — это предметно-ориентированный язык (D
 необходимую информацию для вашего кэша. Если вы ищите легкое решение для
 кэширования, попробуйте {rack-cache}[http://rtomayko.github.com/rack-cache/]:
 
-  require "rack/cache"
-  require "sinatra"
+  require 'rack/cache'
+  require 'sinatra'
 
   use Rack::Cache
 
@@ -1052,7 +1074,7 @@ Sinatra — это предметно-ориентированный язык (D
   значение для заголовка Last-Modified, по умолчанию: mtime (время изменения) файла.
 
 [type]
-  тип файла, по умолчанию: угадывается по расширению файла.
+  тип файла, по умолчанию: предполагается по расширению файла.
 
 [disposition]
   используется для заголовка Content-Disposition, возможные значения:
@@ -1067,7 +1089,7 @@ Sinatra — это предметно-ориентированный язык (D
 Метод <tt>send_file</tt> также обеспечивает автоматическую обработку частичных (range)
 запросов с помощью Sinatra.
 
-=== Доспут к объекту запроса
+=== Доступ к объекту запроса
 
 Объект входящего запроса доступен на уровне обработки запроса (в фильтрах, маршрутах,
 обработчиках ошибок) с помощью <tt>request</tt> метода:
@@ -1089,7 +1111,7 @@ Sinatra — это предметно-ориентированный язык (D
     request["SOME_HEADER"]    # значение заголовка SOME_HEADER
     request.referrer          # источник запроса клиента либо '/'
     request.user_agent        # user agent (используется для :agent условия)
-    request.cookies           # хеш с куками браузера
+    request.cookies           # хеш, содержащий cookies браузера
     request.xhr?              # является ли запрос ajax запросом?
     request.url               # "http://example.com/example/foo"
     request.path              # "/example/foo"
@@ -1099,7 +1121,7 @@ Sinatra — это предметно-ориентированный язык (D
     request.env               # "сырой" env хеш, полученный Rack
   end
 
-Некоторые опции, такие как <tt>script_name</tt> или <tt>path_info</tt> доступны для записи:
+Некоторые опции, такие как <tt>script_name</tt> или <tt>path_info</tt> доступны для изменения:
 
   before { request.path_info = "/" }
   
@@ -1125,7 +1147,7 @@ Sinatra — это предметно-ориентированный язык (D
     "store it!"
   end
 
-Вы также можете указать и имя файла:
+Вы также можете указать имя файла:
 
   get '/' do
     attachment "info.txt"
@@ -1170,8 +1192,8 @@ Sinatra — это предметно-ориентированный язык (D
 а вызывает заданный блок для всех возможных путей. Дело тут не в производительности,
 дело в том, что +render+ вызовет +break+, как только файл не будет найден.
 Содержимое и местонахождение шаблонов будет закэшировано, если приложение запущено не
-в режиме разработки. Вы должны помнить об этих нюансах, если пишите по-настоящему
-сумашедший метод.
+в режиме разработки (set :environment, :development). Вы должны помнить об этих нюансах, 
+если пишите по-настоящему "сумашедший" метод.
 
 == Конфигурация
 
@@ -1252,7 +1274,7 @@ Sinatra — это предметно-ориентированный язык (D
 [environment]         текущее окружение, по умолчанию, значение <tt>ENV['RACK_ENV']</tt>
                       или <tt>"development"</tt>, если <tt>ENV['RACK_ENV']</tt> не доступна.
 
-[logging]             использовать логгер.
+[logging]             использовать логер.
 
 [lock]                создает блокировку для каждого запроса, которая гарантирует обработку
                       только одного запроса в текущий момент времени в Ruby процессе.
@@ -1268,7 +1290,7 @@ Sinatra — это предметно-ориентированный язык (D
                       встроенным сервером.
 
 [prefixed_redirects]  добавлять или нет параметр <tt>request.script_name</tt> к редиректам,
-                      если не задан абсолютный путь. Таким образом  <tt>redirect '/foo'</tt>
+                      если не задан абсолютный путь. Таким образом,  <tt>redirect '/foo'</tt>
                       будет вести себя как <tt>redirect to('/foo')</tt>. Отключено по умолчанию.
 
 [public]              директория, откуда будут раздаваться статические файлы.
@@ -1278,7 +1300,7 @@ Sinatra — это предметно-ориентированный язык (D
 
 [root]                корневая директория проекта.
 
-[raise_errors]        возбуждать исключения (будет останавливать приложение).
+[raise_errors]        выбрасывать исключения (будет останавливать приложение).
 
 [run]                 если включено, Sinatra будет самостоятельно запускать веб-сервер.
                       Не включайте, если используете rackup или аналогичные средства.
@@ -1292,9 +1314,9 @@ Sinatra — это предметно-ориентированный язык (D
 
 [sessions]            включить сессии на основе кук (cookie).
 
-[show_exceptions]     показывать стек вызовов (stack trace) в браузере.
+[show_exceptions]     показывать исключения/стек вызовов (stack trace) в браузере.
 
-[static]              должен ли Sinatra осуществлять раздачу статических файлов.
+[static]              должна ли Sinatra осуществлять раздачу статических файлов.
                       Отключите, когда используете какой-либо веб-сервер для этой цели.
                       Отключение значительно улучшит производительность приложения.
                       Включено по умолчанию.
@@ -1306,9 +1328,9 @@ Sinatra — это предметно-ориентированный язык (D
 Обработчики ошибок исполняются в том же контексте, что и маршруты, +before+-фильтры, а это означает, что всякие
 прелести вроде <tt>haml</tt>, <tt>erb</tt>, <tt>halt</tt> и т.д. доступны и им.
 
-=== NotFound
+=== Not Found
 
-Когда возбуждено исключение <tt>Sinatra::NotFound</tt>, или кодом ответа является 404,
+Когда выброшено исключение <tt>Sinatra::NotFound</tt>, или кодом ответа является 404,
 то будет вызван <tt>not_found</tt> обработчик:
 
   not_found do
@@ -1317,7 +1339,7 @@ Sinatra — это предметно-ориентированный язык (D
 
 === Ошибки
 
-Обработчик ошибок +error+ будет вызван, когда исключение возбуждено из блока маршрута, либо из фильтра.
+Обработчик ошибок +error+ будет вызван, когда исключение выброшено из блока маршрута, либо из фильтра.
 Объект-исключение доступен как переменная <tt>sinatra.error</tt> в Rack:
 
   error do
@@ -1356,7 +1378,7 @@ Sinatra — это предметно-ориентированный язык (D
     'Boom'
   end
 
-Sinatra устанавливает специальные <tt>not_found</tt> и <tt>error</tt> обработчики, когда запущен в режиме
+Sinatra устанавливает специальные <tt>not_found</tt> и <tt>error</tt> обработчики, когда приложение запущено в режиме
 разработки (окружение <tt>:development</tt>).
 
 == Rack "прослойки"
@@ -1364,7 +1386,7 @@ Sinatra устанавливает специальные <tt>not_found</tt> и
 Sinatra использует Rack[http://rack.rubyforge.org/], минимальный стандартный 
 интерфейс для веб-фреймворков на Ruby. Одной из самых интересных для разработчиков возможностей Rack
 является поддержка "прослоек" ("middleware") — компонентов,
-"сидящих" между сервером и вашим приложением, которые отслеживают и/или манипулируют
+находящихся "между" сервером и вашим приложением, которые отслеживают и/или манипулируют
 HTTP запросами/ответами для предоставления различной функциональности.
 
 В Sinatra очень просто использовать такие "прослойки" с помощью метода +use+:
@@ -1391,7 +1413,7 @@ Rack::Builder[http://rack.rubyforge.org/doc/classes/Rack/Builder.html] DSL
 Rack распространяется с различными стандартными "прослойками"
 для логирования, отладки, маршрутизации URL, аутентификации, обработки сессий. Sinatra использует
 многие из этих компонентов автоматически, основываясь на конфигурации, чтобы вам не приходилось
-регистрировать/использовать (+use+) их вручную.
+подключать (+use+) их вручную.
 
 == Тестирование
 
@@ -1432,9 +1454,9 @@ Rack распространяется с различными стандартн
 
 Описание своего приложения самым простейшим способом (с помощью DSL верхнего уровня, как в примерах выше)
 работает отлично для крохотных приложений, но имеет множество недостатков, когда надо создать компоненты, такие как
-Rack middleware ("прослойки"), Rails metal, простые библиотеки с серверными компонентами,
-расширения Sinatra.
-DSL верхнего уровня загрязняет пространство имен <tt>Object</tt> и подразумевает стиль конфигурации
+Rack middleware ("прослойки"), Rails metal, простые библиотеки с серверными компонентами, расширения Sinatra.
+
+DSL верхнего уровня "загрязняет" пространство имен <tt>Object</tt> и подразумевает стиль конфигурации
 микро-приложения (например, единый файл приложения, ./public и
 ./views директории, создание логов, страницу деталей об исключениях 
 и т.д.). И тут на помощь приходит Sinatra::Base:
@@ -1450,13 +1472,13 @@ DSL верхнего уровня загрязняет пространство
     end
   end
 
-Методы, доступные Sinatra::Base сабклассам идентичны тем, что доступны
+Методы, доступные Sinatra::Base подклассам идентичны тем, что доступны
 в DSL верхнего уровня. Большинство приложений верхнего уровня могут быть
 конвертированы в Sinatra::Base компоненты с помощью двух модификаций:
 
 * Вы должны подключать <tt>sinatra/base</tt> вместо +sinatra+,
   иначе все методы предоставляемые Sinatra будут импортированы в глобальное пространство имен.
-* Поместите все маршруты, обработчики ошибок, фильтры и опции в сабкласс Sinatra::Base.
+* Поместите все маршруты, обработчики ошибок, фильтры и опции в подкласс Sinatra::Base.
 
 <tt>Sinatra::Base</tt> — это чистый лист. Большинство опций, включая встроенный сервер, по умолчанию отключены.
 Смотрите {Опции и Конфигурация}[http://www.sinatrarb.com/configuration.html] для детальной информации
@@ -1540,8 +1562,8 @@ Rack-совместимый сервер приложений.
 Вот несколько причин, по которым вы, возможно, захотите использовать <tt>config.ru</tt>:
 
 * вы хотите разворачивать свое приложение на различных Rack-совместимых серверах (Passenger, Unicorn,
-  Heroku, ...).
-* вы хотите использовать более одного сабкласса <tt>Sinatra::Base</tt>.
+  Heroku, ...);
+* вы хотите использовать более одного подкласса <tt>Sinatra::Base</tt>;
 * вы хотите использовать Sinatra только в качестве "прослойки" Rack.
 
 <b>Совсем необязательно переходить на использование <tt>config.ru</tt> лишь потому, что вы стали
@@ -1551,7 +1573,7 @@ Rack-совместимый сервер приложений.
 === Использование Sinatra в качестве "прослойки"
 
 Не только сам Sinatra может использовать "прослойки" Rack, но и любое Sinatra приложение
-само может быть добавлено к любому Rack эндпоинту в качестве "прослойки". Этим эндпоинтом
+само может быть добавлено к любому Rack endpoint в качестве "прослойки". Этим endpoint (конечной точкой)
 может быть другое Sinatra приложение, или приложение, основанное на Rack (Rails/Ramaze/Camping/...):
 
   require 'sinatra/base'
@@ -1590,10 +1612,9 @@ Rack-совместимый сервер приложений.
 
 === Область видимости приложения / класса
 
-Любое Sinatra приложение соответствует сабклассу Sinatra::Base. Если вы 
-используете DSL верхнего 
-уровня (<tt>require 'sinatra'</tt>), то этим классом будет 
-Sinatra::Application, иначе это будет сабкласс, который вы создали вручную.
+Любое Sinatra приложение соответствует подклассу Sinatra::Base. Если вы 
+используете DSL верхнего уровня (<tt>require 'sinatra'</tt>), то этим классом будет 
+Sinatra::Application, иначе это будет подкласс, который вы создали вручную.
 На уровне класса вам будут доступны такие методы, как +get+ или +before+, но вы
 не сможете иметь доступ к объектам +request+ или +session+, так как существует
 только один класс приложения для всех запросов.
@@ -1612,15 +1633,15 @@ Sinatra::Application, иначе это будет сабкласс, котор
 
 У вас будет область видимости приложения внутри:
 
-* Тела вашего класса приложения
-* Методов, определенных расширениями
-* Блока, переданного в +helpers+
-* Блоков, использованных как значения для +set+
+* тела вашего класса приложения;
+* методов, определенных расширениями;
+* блока, переданного в +helpers+;
+* блоков, использованных как значения для +set+.
 
 Вы можете получить доступ к объекту области видимости (классу приложения) следующими способами:
 
-* объект, переданный блокам конфигурации (<tt>configure { |c| ... }</tt>)
-* +settings+ внутри области видимости запроса
+* через объект, переданный блокам конфигурации (<tt>configure { |c| ... }</tt>);
+* +settings+ внутри области видимости запроса.
 
 === Область видимости запроса/экземпляра
 
@@ -1628,7 +1649,7 @@ Sinatra::Application, иначе это будет сабкласс, котор
 и все блоки обработчика будут запущены в этом контексте. В этой области
 видимости вам доступны +request+ и +session+ объекты, вызовы методов
 рендеринга, такие как +erb+ или +haml+. Вы можете получить доступ к
-области видимости приложения из контекста запроса, используя помощник +settings+:
+области видимости приложения из контекста запроса, используя метод-помощник +settings+:
 
   class MyApp < Sinatra::Base
     # Я в области видимости приложения!
@@ -1647,10 +1668,10 @@ Sinatra::Application, иначе это будет сабкласс, котор
 
 У вас будет область видимости запроса внутри:
 
-* get/head/post/put/delete/options блоков
-* before/after фильтрах
-* методах помощниках 
-* шаблонах/видах
+* get/head/post/put/delete/options блоков;
+* before/after фильтрах;
+* методах-помощниках;
+* шаблонах/отображениях.
 
 === Область видимости делегирования
 
@@ -1664,8 +1685,8 @@ Sinatra::Application, иначе это будет сабкласс, котор
 
 У вас будет контекст делегирования внутри:
 
-* Привязки верхнего уровня, если вы сделали <tt>require "sinatra"</tt>
-* Объекта, расширенного с помощью примеси <tt>Sinatra::Delegator</tt>
+* привязки верхнего уровня, если вы сделали <tt>require 'sinatra'</tt>;
+* объекта, расширенного с помощью <tt>Sinatra::Delegator</tt>.
 
 Посмотрите сами в код: тут
 {Sinatra::Delegator примесь}[http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/base.rb#L1128]
@@ -1679,12 +1700,12 @@ Sinatra приложения могут быть запущены напряму
 
 Опции включают:
 
-  -h # помощь
-  -p # настроить порт (по умолчанию 4567)
-  -o # настроить хост (по умолчанию 0.0.0.0)
-  -e # настроить окружение, режим (по умолчанию development)
-  -s # настроить rack сервер/обработчик (по умолчанию thin)
-  -x # включить мьютекс (по умолчанию выключен)
+  -h # раздел помощи
+  -p # указание порта (по умолчанию 4567)
+  -o # указание хоста (по умолчанию 0.0.0.0)
+  -e # указание окружения, режима (по умолчанию development)
+  -s # указание rack сервера/обработчика (по умолчанию thin)
+  -x # включить мьютекс-блокировку (по умолчанию выключена)
 
 == Системные требования
 
@@ -1695,12 +1716,12 @@ Sinatra приложения могут быть запущены напряму
   этой версии, рекомендуем обновиться до 1.9.2 или перейти на JRuby или Rubinius.
 
 [ Ruby 1.9.2 ]
-  1.9.2 поддерживается и рекомендована. Заметьте, что Radius и Markaby
+  1.9.2 поддерживается и рекомендована к использованию. Заметьте, что Radius и Markaby
   пока несовместимы с 1.9.2. Не используйте 1.9.2p0, известно, что эта
   версия весьма не стабильна при использовании Sinatra.
 
 [ Rubinius ]
-  Rubinius официально поддерживается (Rubinius >= 1.2.3), все, включая все
+  Rubinius официально поддерживается (Rubinius >= 1.2.3), всё, включая все
   языки шаблонов, работает.
 
 [ JRuby ]
@@ -1712,37 +1733,35 @@ Sinatra приложения могут быть запущены напряму
 
 <b>Ruby 1.8.6 больше не поддерживается.</b>
 
-Мы также следим за новыми версиями Ruby.
+Мы также следим за предстоящими к выходу версиями Ruby.
 
 Следующие реализации Ruby не поддерживаются официально, но известно, что на
 них запускается Sinatra:
 
-* Старые версии JRuby и Rubinius
-* MacRuby, Maglev, IronRuby
-* Ruby 1.9.0 и 1.9.1
-* Ruby 1.8.6 с помощью {backports}[https://github.com/marcandre/backports/#readme]
+* старые версии JRuby и Rubinius;
+* MacRuby, Maglev, IronRuby;
+* Ruby 1.9.0 и 1.9.1;
+* Ruby 1.8.6 с помощью {backports}[https://github.com/marcandre/backports/#readme].
 
 То, что версия официально не поддерживается, означает, что, если что-то не
-работает на этой версии, а на поддерживаемой работает, то мы предполагаем,
-что это не наша проблема, а их.
+работает на этой версии, а на поддерживаемой работает - это не наша проблема, а их.
 
 Мы также запускаем наши CI-тесты на последней версии Ruby (предстоящий 1.9.3),
 но мы не можем ничего гарантировать, так как она постоянно развивается.
 Предполагается, что 1.9.3p0 будет поддерживаться.
 
-Sinatra должен работать на любой операционной системе, поддерживаемой выбранной
-реализацией Ruby.
+Sinatra должна работать на любой операционной системе, в которой есть одна из указанных выше версий Ruby.
 
 == На острие
 
 Если вы хотите использовать самый последний код Sinatra, не бойтесь запускать
-свое приложение вместе с master бранчем Sinatra, он весьма стабилен.
+свое приложение вместе из master ветки Sinatra, она весьма стабильна.
 
 Мы также время от времени выпускаем предварительные версии, так что вы можете делать так:
 
   gem install sinatra --pre
 
-Чтобы воспользоваться некоторыми самыми последними возможностям.
+Чтобы воспользоваться некоторыми самыми последними возможностями.
 
 === С помощью Bundler
 
@@ -1766,7 +1785,7 @@ Sinatra должен работать на любой операционной
 в этом файле. Однако, непосредственные зависимости Sinatra (Rack и Tilt) Bundler
 автоматически скачает и добавит.
 
-Теперь вы можете запускать свое приложение примерно так:
+Теперь вы можете запускать свое приложение так:
 
   bundle exec ruby myapp.rb
 
@@ -1804,10 +1823,10 @@ SemVerTag.
 
 == Дальнейшее чтение
 
-* {Вебсайт проекта}[http://www.sinatrarb.com/] - Дополнительная документация,
+* {Веб-сайт проекта}[http://www.sinatrarb.com/] - Дополнительная документация,
   новости и ссылки на другие ресурсы.
-* {Участие}[http://www.sinatrarb.com/contributing] - Нашли баг? Нужна помощь?	Написали патч?
-* {Слежение за проблемами}[http://github.com/sinatra/sinatra/issues]
+* {Участие в проекте}[http://www.sinatrarb.com/contributing] - Обнаружили баг? Нужна помощь? Написали патч?
+* {Слежение за проблемами/ошибками}[http://github.com/sinatra/sinatra/issues]
 * {Twitter}[http://twitter.com/sinatra]
-* {Лист рассылки}[http://groups.google.com/group/sinatrarb/topics]
-* {IRC: #sinatra}[irc://chat.freenode.net/#sinatra] on http://freenode.net 
+* {Группы рассылки}[http://groups.google.com/group/sinatrarb/topics]
+* {IRC: #sinatra}[irc://chat.freenode.net/#sinatra] on http://freenode.net