sinatra 1.3.0.e → 1.3.0.f

data/README.hu.rdoc

@@ -99,9 +99,9 @@ tervezhetők, így például az user agent karakterláncot alapul véve:
 
 A statikus fájlok kiszolgálása a <tt>./public</tt> könyvtárból
 történik, de természetesen más könyvtárat is megadhatsz erre a célra,
-mégpedig a <tt>:public</tt> kapcsoló beállításával:
+mégpedig a <tt>:public_folder</tt> kapcsoló beállításával:
 
-  set :public, File.dirname(__FILE__) + '/static'
+  set :public_folder, File.dirname(__FILE__) + '/static'
 
 Fontos mgejegyezni, hogy a nyilvános könyvtár neve nem szerepel az URL-ben.
 A <tt>./public/css/style.css</tt> fájl az

data/README.jp.rdoc

@@ -153,9 +153,9 @@ Rackレスポンス、Rackボディオブジェクト、HTTPステータスコ
 == 静的ファイル
 
 静的ファイルは<tt>./public</tt>ディレクトリから配信されます。
-<tt>:public</tt>オプションを指定することで別の場所を指定することができます。
+<tt>:public_folder</tt>オプションを指定することで別の場所を指定することができます。
 
-  set :public, File.dirname(__FILE__) + '/static'
+  set :public_folder, File.dirname(__FILE__) + '/static'
 
 注意: この静的ファイル用のディレクトリ名はURL中に含まれません。
 例えば、<tt>./public/css/style.css</tt>は<tt>http://example.com/css/style.css</tt>でアクセスできます。

data/README.pt-br.rdoc

@@ -95,9 +95,9 @@ Rotas podem incluir uma variedade de condições correspondes, tal como o agente
 == Arquivos estáticos
 
 Arquivos estáticos são disponibilizados a partir do diretório <tt>./public</tt>. Você pode especificar
-um local diferente pela opção <tt>:public</tt>
+um local diferente pela opção <tt>:public_folder</tt>
 
-  set :public, File.dirname(__FILE__) + '/estatico'
+  set :public_folder, File.dirname(__FILE__) + '/estatico'
 
 Note que o nome do diretório público não é incluido na URL. Um arquivo
 <tt>./public/css/style.css</tt> é disponibilizado como

data/README.pt-pt.rdoc

@@ -95,9 +95,9 @@ Rotas podem incluir uma variedade de condições correspondentes, por exemplo, o
 == Arquivos estáticos
 
 Arquivos estáticos são disponibilizados a partir do directório <tt>./public</tt>. Você pode especificar
-um local diferente através da opção <tt>:public</tt>
+um local diferente através da opção <tt>:public_folder</tt>
 
-  set :public, File.dirname(__FILE__) + '/estatico'
+  set :public_folder, File.dirname(__FILE__) + '/estatico'
 
 Note que o nome do directório público não é incluido no URL. Um arquivo
 <tt>./public/css/style.css</tt> é disponibilizado como

data/README.rdoc

@@ -98,6 +98,15 @@ Or with a block parameter:
     "Hello, #{c}!"
   end
 
+Route patterns may have optional parameters:
+
+  get '/posts.?:format?' do
+    # matches "GET /posts" and any extension "GET /posts.json", "GET /posts.xml" etc.
+  end
+
+By the way, unless you disable the path traversal attack protection (see below),
+the request path might be modified before matching against your routes.
+
 === Conditions
 
 Routes may include a variety of matching conditions, such as the user agent:
@@ -135,7 +144,25 @@ You can easily define your own conditions:
   get '/win_a_car' do
     "Sorry, you lost."
   end
+  
+For a condition that takes multiple values use a splat:
 
+  set(:auth) do |*roles|   # <- notice the splat here
+    condition do
+      unless logged_in? && roles.any? {|role| current_user.in_role? role }
+        redirect "/login/", 303 
+      end
+    end
+  end
+
+  get "/my/account/", :auth => [:user, :admin] do
+    "Your Account Details"
+  end
+  
+  get "/only/admin/", :auth => :admin do
+    "Only admins are allowed here!"
+  end
+  
 === Return Values
 
 The return value of a route block determines at least the response body passed
@@ -164,6 +191,9 @@ That way we can, for instance, easily implement a streaming example:
 
     get('/') { Stream.new }
 
+You can also use the +stream+ helper method (described below) to reduce boiler
+plate and embed the streaming logic in the route.
+
 === Custom Route Matchers
 
 As shown above, Sinatra ships with built-in support for using String patterns
@@ -208,9 +238,9 @@ Or, using negative look ahead:
 == Static Files
 
 Static files are served from the <tt>./public</tt> directory. You can specify
-a different location by setting the <tt>:public</tt> option:
+a different location by setting the <tt>:public_folder</tt> option:
 
-  set :public, File.dirname(__FILE__) + '/static'
+  set :public_folder, File.dirname(__FILE__) + '/static'
 
 Note that the public directory name is not included in the URL. A file
 <tt>./public/css/style.css</tt> is made available as
@@ -291,7 +321,7 @@ Available Options:
 [layout_engine]
   Template engine to use for rendering the layout. Useful for languages that
   do not support layouts otherwise. Defaults to the engine used for the
-  temple. Example: <tt>set :rdoc, :layout_engine => :erb</tt>
+  template. Example: <tt>set :rdoc, :layout_engine => :erb</tt>
 
 Templates are assumed to be located directly under the <tt>./views</tt>
 directory. To use a different views directory:
@@ -418,7 +448,7 @@ template than for the layout by passing the <tt>:layout_engine</tt> option.
 
 Dependency::        {rdoc}[http://rdoc.rubyforge.org/]
 File Extensions::   <tt>.rdoc</tt>
-Example::           <tt>textile :README, :layout_engine => :erb</tt>
+Example::           <tt>rdoc :README, :layout_engine => :erb</tt>
 
 It is not possible to call methods from rdoc, nor to pass locals to it. You
 therefore will usually use it in combination with another rendering engine:
@@ -668,7 +698,7 @@ Note that <tt>enable :sessions</tt> actually stores all data in a cookie. This
 might not always be what you want (storing lots of data will increase your
 traffic, for instance). You can use any Rack session middleware: in order to
 do so, do *not* call <tt>enable :sessions</tt>, but instead pull in your
-middleware of choice how you would any other middleware:
+middleware of choice as you would any other middleware:
 
   use Rack::Session::Pool, :expire_after => 2592000
 
@@ -781,7 +811,7 @@ Similar to the body, you can also set the status code and headers:
   get '/foo' do
     status 418
     headers \
-      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN"
+      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN",
       "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
     body "I'm a tea pot!"
   end
@@ -789,6 +819,54 @@ Similar to the body, you can also set the status code and headers:
 Like +body+, +headers+ and +status+ with no arguments can be used to access
 their current values.
 
+=== Streaming Responses
+
+Sometimes you want to start sending out data while still generating parts of
+the response body. In extreme examples, you want to keep sending data until
+the client closes the connection. You can use the +stream+ helper to avoid
+creating your own wrapper:
+
+  get '/' do
+    stream do |out|
+      out << "It's gonna be legen -\n"
+      sleep 0.5
+      out << " (wait for it) \n"
+      sleep 1
+      out << "- dary!\n"
+    end
+  end
+
+This allows you to implement streaming APIs,
+{Server Sent Events}[http://dev.w3.org/html5/eventsource/] and can be used as
+basis for {WebSockets}[http://en.wikipedia.org/wiki/WebSocket]. It can also be
+used to increase throughput if some but not all content depends on a slow
+resource.
+
+Note that the streaming behavior, especially the number of concurrent request,
+highly depends on the web server used to serve the application. Some servers,
+like WEBRick, might not even support streaming at all. If the server does not
+support streaming, the body will be sent all at once after the block passed to
++stream+ finished executing.
+
+If the optional parameter is set to +keep_open+, it will not call +close+ on
+the stream object, allowing you to close it at any later point in the
+execution flow. This only works on evented servers, like Thin and Rainbows.
+Other servers will still close the stream:
+
+  set :server, :thin
+  connections = []
+
+  get '/' do
+    # keep stream open
+    stream(:keep_open) { |out| connections << out }
+  end
+
+  post '/' do
+    # write to all open streams
+    connections.each { |out| out << params[:message] << "\n" }
+    "message sent"
+  end
+
 === Logging
 
 In the request scope, the +logger+ helper exposes a +Logger+ instance:
@@ -870,7 +948,7 @@ To pass arguments with a redirect, either add them to the query:
 
 Or use a session:
 
-  enable :session
+  enable :sessions
   
   get '/foo' do
     session[:secret] = 'foo'
@@ -905,7 +983,7 @@ If you are using the +expires+ helper to set the corresponding header,
     expires 500, :public, :must_revalidate
   end
 
-To properly use caches, you should consider using +etag+ and +last_modified+.
+To properly use caches, you should consider using +etag+ or +last_modified+.
 It is recommended to call those helpers *before* doing heavy lifting, as they
 will immediately flush a response if the client already has the current
 version in its cache:
@@ -923,7 +1001,7 @@ It is also possible to use a
   etag @article.sha1, :weak
 
 These helpers will not do any caching for you, but rather feed the necessary
-information to your cache. If you are looking for a quick caching solutions, 
+information to your cache. If you are looking for a quick reverse-proxy caching solution, 
 try {rack-cache}[http://rtomayko.github.com/rack-cache/]:
 
   require "rack/cache"
@@ -1044,6 +1122,37 @@ You can also pass it a file name:
     "store it!"
   end
 
+=== Dealing with Date and Time
+
+Sinatra offers a +time_for+ helper method, which, from the given value
+generates a Time object. It is also able to convert +DateTime+, +Date+ and
+similar classes:
+
+  get '/' do
+    pass if Time.now > time_for('Dec 23, 2012')
+    "still time"
+  end
+
+This method is used internally by +expires+, +last_modified+ and akin. You can
+therefore easily extend the behavior of those methods by overriding +time_for+
+in your application:
+
+  helpers do
+    def time_for(value)
+      case value
+      when :yesterday then Time.now - 24*60*60
+      when :tomorrow  then Time.now + 24*60*60
+      else super
+      end
+    end
+  end
+
+  get '/' do
+    last_modified :yesterday
+    expires :tomorrow
+    "hello"
+  end
+
 === Looking Up Template Files
 
 The <tt>find_template</tt> helper is used to find template files for rendering:
@@ -1132,6 +1241,23 @@ You can access those options via <tt>settings</tt>:
     ...
   end
 
+=== Configuring attack protection
+
+Sinatra is using
+{Rack::Protection}[https://github.com/rkh/rack-protection#readme] to defend
+you application against common, opportunistic attacks. You can easily disable
+this behavior (which should result in performance gains):
+
+  disable :protection
+
+To skip a single defense layer, set +protection+ to an options hash:
+
+  set :protection, :except => :path_traversal
+
+You can also hand in an array in order to disable a list of protections:
+
+  set :protections, :except => [:path_traversal, :session_hijacking]
+
 === Available Settings
 
 [absolute_redirects]   If disabled, Sinatra will allow relative redirects,
@@ -1184,7 +1310,10 @@ You can access those options via <tt>settings</tt>:
                        <tt>redirect '/foo'</tt> would behave like
                        <tt>redirect to('/foo')</tt>. Disabled per default.
 
-[public]               folder public files are served from
+[protection]           Whether or not to enable web attack protections. See
+                       protection section above.
+
+[public_folder]        folder public files are served from
 
 [reload_templates]     whether or not to reload templates between requests.
                        Enabled in development mode.
@@ -1219,6 +1348,9 @@ You can access those options via <tt>settings</tt>:
                        Use an explicit array when setting multiple values:
                        <tt>set :static_cache_control, [:public, :max_age => 300]</tt>
 
+[threaded]             If set to +true+, will tell Thin to use
+                       <tt>EventMachine.defer</tt> for processing the request.
+
 [views]                views folder.
 
 == Error Handling
@@ -1523,6 +1655,7 @@ assign them to a constant, you can do this with <tt>Sinatra.new</tt>:
 
 It takes the application to inherit from as optional argument:
 
+  # config.ru
   require 'sinatra/base'
 
   controller = Sinatra.new do
@@ -1659,47 +1792,59 @@ The following Ruby versions are officially supported:
 
 [ Ruby 1.8.7 ]
   1.8.7 is fully supported, however, if nothing is keeping you from it, we
-  recommend upgrading to 1.9.2 or switching to JRuby or Rubinius.
+  recommend upgrading to 1.9.2 or switching to JRuby or Rubinius. Support for
+  1.8.7 will not be dropped before Sinatra 2.0 and Ruby 2.0 except maybe for
+  the unlikely event of 1.8.8 being released. Even then, we might continue
+  supporting it. <b>Ruby 1.8.6 is no longer supported.</b> If you want to run
+  with 1.8.6, downgrade to Sinatra 1.2, which will receive bug fixes until
+  Sinatra 1.4.0 is released.
 
 [ Ruby 1.9.2 ]
-  1.9.2 is supported and recommended. Note that Radius and Markaby are
-  currently not 1.9 compatible. Do not use 1.9.2p0, it is known to cause
-  segmentation faults when running Sinatra.
+  1.9.2 is fully supported and recommended. Note that Radius and Markaby
+  are currently not 1.9 compatible. Do not use 1.9.2p0, it is known to cause
+  segmentation faults when running Sinatra. Support will continue at least
+  until the release of Ruby 1.9.4/2.0 and support for the latest 1.9 release
+  will continue as long as it is still supported by the Ruby core team.
+
+[ Ruby 1.9.3 ]
+  While we test against 1.9.3 we do not know of anyone using it in
+  production yet, and as with 1.9.2, you might want to be careful with
+  patch level zero.
 
 [ Rubinius ]
-  Rubinius is officially supported (Rubinius >= 1.2.3), everything, including
+  Rubinius is officially supported (Rubinius >= 1.2.4), everything, including
   all template languages, works.
 
 [ JRuby ]
-  JRuby is officially supported (JRuby >= 1.6.1). No issues with third party
+  JRuby is officially supported (JRuby >= 1.6.3). No issues with third party
   template libraries are known, however, if you choose to use JRuby, please
   look into JRuby rack handlers, as the Thin web server is not fully supported
   on JRuby. JRuby's support for C extensions is still experimental, which only
   affects RDiscount and Redcarpet at the moment.
 
-<b>Ruby 1.8.6 is no longer supported.</b> If you want to run with 1.8.6,
-downgrade to Sinatra 1.2, which will receive bug fixes until Sinatra 1.4.0 is
-released.
-
 We also keep an eye on upcoming Ruby versions.
 
 The following Ruby implementations are not officially supported but still are
 known to run Sinatra:
 
 * Older versions of JRuby and Rubinius
+* Ruby Enterprise Edition
 * MacRuby, Maglev, IronRuby
-* Ruby 1.9.0 and 1.9.1
+* Ruby 1.9.0 and 1.9.1 (but we do recommend against using those)
 
 Not being officially supported means if things only break there and not on a
 supported platform, we assume it's not our issue but theirs.
 
-We also run our CI against ruby-head (the upcoming 1.9.3), but we can't
-guarantee anything, since it is constantly moving. Expect 1.9.3p0 to be
+We also run our CI against ruby-head (the upcoming 1.9.4), but we can't
+guarantee anything, since it is constantly moving. Expect 1.9.4p0 to be
 supported.
 
 Sinatra should work on any operating system supported by the chosen Ruby
 implementation.
 
+You will not be able to run Sinatra on Cardinal, SmallRuby, BlueRuby or any
+Ruby version prior to 1.8.7 as of the time being.
+
 == The Bleeding Edge
 
 If you would like to use Sinatra's latest bleeding code, feel free to run your
@@ -1785,3 +1930,4 @@ SemVerTag.
 * API documentation for the {latest release}[http://rubydoc.info/gems/sinatra]
   or the {current HEAD}[http://rubydoc.info/github/sinatra/sinatra] on
   http://rubydoc.info
+* {CI server}[http://ci.rkh.im/view/Sinatra/]

data/README.ru.rdoc

@@ -1,5 +1,5 @@
 = Sinatra
-<i>Внимание: Этот документ является переводом Английской версии и может быть устаревшим</i>
+<i>Внимание: Этот документ является переводом английской версии и может быть устаревшим</i>
 
 Sinatra — это предметно-ориентированный каркас (DSL) для быстрого создания функциональных веб-приложений на Ruby:
 
@@ -52,7 +52,8 @@ Thin - это более производительный и функциона
     .. что-то ответить ..
   end
 
-Маршруты сверяются с запросом в порядке очередности их записи в файле приложения. По умолчанию, будет вызван первый совпавший с запросом маршрут.
+Маршруты сверяются с запросом в порядке очередности их записи в файле приложения. По умолчанию
+будет вызван первый совпавший с запросом маршрут.
 
 Шаблоны маршрутов могут включать в себя параметры доступные в
 <tt>params</tt> xэше:
@@ -82,6 +83,12 @@ Thin - это более производительный и функциона
     params[:splat] # => ["path/to/file", "xml"]
   end
 
+Или с параметрами блока:
+
+  get '/download/*.*' do |path, ext|
+    [path, ext] # => ["path/to/file", "xml"]
+  end
+
 Маршруты также могут содержать регулярные выражения:
 
   get %r{/hello/([\w]+)} do
@@ -138,7 +145,8 @@ Thin - это более производительный и функциона
 или следующей "прослойкой" (middleware) в Rack стеке. Чаще всего это строка, как в примерах выше.
 Но и другие значения также приемлемы.
 
-Вы можете вернуть любой объект, который будет либо корректным Rack ответом, объектом Rack body, либо кодом состояния HTTP:
+Вы можете вернуть любой объект, который будет либо корректным Rack ответом, объектом Rack body,
+либо кодом состояния HTTP:
 
 * массив с тремя переменными: <tt>[status (Fixnum), headers (Hash), response body (должен отвечать на #each)]</tt>;
 * массив с двумя переменными: <tt>[status (Fixnum), response body (должен отвечать на #each)]</tt>;
@@ -198,208 +206,177 @@ Thin - это более производительный и функциона
 == Статические файлы
 
 Статические файлы отдаются из <tt>./public</tt> директории. Вы можете указать другое место,
-указав его через опцию <tt>:public</tt>:
+указав его через опцию <tt>:public_folder</tt>:
 
-  set :public, File.dirname(__FILE__) + '/static'
+  set :public_folder, File.dirname(__FILE__) + '/static'
 
 Учтите, что имя директории со статическими файлами не включено в URL. Например, файл
 <tt>./public/css/style.css</tt> будет доступен как
 <tt>http://example.com/css/style.css</tt>.
 
-== Представления / Шаблоны
-
-Шаблоны по умолчанию должны находиться в директории <tt>./views</tt>.
-Для использования другой директории шаблонов:
+Используйте опцию <tt>:static_cache_control</tt> (см. ниже), чтобы
+добавить заголовок <tt>Cache-Control</tt>.
 
-  set :views, File.dirname(__FILE__) + '/templates'
-
-Важно помнить, что вы всегда должны указывать шаблоны
-с помощью символов, даже если это подкаталог (в этом случае
-используйте <tt>:'subdir/template'</tt>). Вы должны использовать
-символ, иначе методы рендеринга, отобразят просто переданную им строку.
-
-=== Haml шаблоны
-
-<tt>haml</tt> gem/библиотека необходима для рендеринга HAML шаблонов:
+== Представления / Шаблоны
 
-  # Вам нужно будет подключить haml gem в приложении
-  require 'haml'
+Каждый шаблонизатор представлен своим собственным методом. Эти методы
+попросту возвращают строку:
 
   get '/' do
-    haml :index
+    erb :index
   end
 
-Отобразит <tt>./views/index.haml</tt>.
-
-{Опции Haml}[http://haml-lang.com/docs/yardoc/file.HAML_REFERENCE.html#options]
-могут быть установлены глобально через конфигурацию Sinatra,
-см. {Опции и Конфигурация}[http://www.sinatrarb.com/configuration.html],
-и переопределены локально.
+Отобразит <tt>views/index.erb</tt>.
 
-  set :haml, :format => :html5 # :xhtml - Haml формат по умолчанию
+Вместо имени шаблона вы так же можете передавать непосредственно само
+содержимое шаблона
 
   get '/' do
-    haml :index, :format => :html4 # переопределен
+    code = "<%= Time.now >"
+    erb code
   end
 
-
-=== Erb шаблоны
-
-  # Вам нужно будет подключить erb в приложении
-  require 'erb'
+Эти методы принимают второй аргумент, хеш с опциями:
 
   get '/' do
-    erb :index
+    erb :index, :layout => :post
   end
 
-Отобразит <tt>./views/index.erb</tt>.
-
-=== Erubis шаблоны
+Отобразит <tt>views/index.erb</tt>, вложенным в
+<tt>views/post.erb</tt> (по умолчанию: <tt>views/layout.erb</tt>, если существует).
 
-<tt>erubis</tt> gem/библиотека необходима для рендеринга Erubis шаблонов:
-
-  # Вам нужно будет подключить Erubis в приложении
-  require 'erubis'
+Любые опции, не понимаемые Sinatra, будут переданы в шаблонизатор
 
   get '/' do
-    erubis :index
+    haml :index, :format => :html5
   end
 
-Отобразит <tt>./views/index.erubis</tt>.
-
-Также возможно заменить Erb на Erubis:
+Вы также можете задавать опции для шаблонизаторов в общем:
 
-  require 'erubis'
-  Tilt.register :erb, Tilt[:erubis]
+  set :haml, :format => :html5
 
   get '/' do
-    erb :index
+    haml :index
   end
 
-Отобразит <tt>./views/index.erb</tt> с помощью Erubis.
+Опции, переданные в метод, переопределяют опции, заданные с помощью
++set+.
 
-=== Builder шаблоны
+Доступные опции:
 
-<tt>builder</tt> gem/библиотека необходима для рендеринга builder шаблонов:
+[locals]
+  Список локальных переменных, передаваемых в документ.
+  Например: <tt>erb "<%= foo %>", :locals => {:foo => "bar"}</tt>
 
-  # Вам нужно будет подключить builder в приложении
-  require 'builder'
-
-  get '/' do
-    builder :index
-  end
+[default_encoding]
+  Кодировка, которую следует использовать, если не удалось определить
+  оригинальную. По умолчанию: <tt>settings.default_encoding</tt>.
 
-Отобразит <tt>./views/index.builder</tt>.
+[views]
+  Директория с шаблонами. По умолчанию: <tt>settings.views</tt>.
 
-=== Nokogiri шаблоны
+[layout]
+  Использовать или нет лэйаут (+true+ или +false+). Если же значение Symbol,
+  то указывает, какой шаблон использовать в качестве лэйаута. Например:
+  <tt>erb :index, :layout => !request.xhr?</tt>
 
-<tt>nokogiri</tt> gem/библиотека необходима для рендеринга nokogiri шаблонов:
+[content_type]
+  Content-Type отображенного шаблона. По умолчанию: задается шаблонизатором.
 
-  # Вам нужно будет подключить nokogiri в приложении
-  require 'nokogiri'
+[scope]
+  Область видимости, в которой рендерятся шаблоны. По умолчанию: экземпляр
+  приложения. Если вы измените эту опцию, то переменные экземпляра и
+  методы-помощники станут недоступными в ваших шаблонах.
 
-  get '/' do
-    nokogiri :index
-  end
+[layout_engine]
+  Шаблонизатор, который следует использовать для отображения лэйаута. Полезная
+  опция для шаблонизаторов, в которых нет никакой поддержки лэйаутов. По
+  умолчанию: тот же шаблонизатор, что используется и для самого шаблона.
+  Пример: <tt>set :rdoc, :layout_engine => :erb</tt>
 
-Отобразит <tt>./views/index.nokogiri</tt>.
+По умолчанию считается, что шаблоны находятся в директории <tt>./views</tt>.
+Чтобы использовать другую директорию с шаблонами:
 
-=== Sass шаблоны
+  set :views, settings.root + '/templates'
 
-<tt>haml</tt> gem/библиотека необходима для рендеринга Sass шаблонов:
+Важное замечание: вы всегда должны ссылаться на шаблоны с помощью символов
+(Symbol), даже когда они в поддиректории (в этом случае используйте
+<tt>:'subdir/template'</tt>). Вы должны использовать символы, потому что
+иначе шаблонизаторы попросту отображают любые строки, переданные им.
 
-  # Вам нужно будет подключить haml или sass в приложении
-  require 'sass'
+=== Доступные шаблонизаторы
 
-  get '/stylesheet.css' do
-    sass :stylesheet
-  end
+Некоторые языки шаблонов имеют несколько реализаций. Чтобы указать, какую
+реализацию использовать, вам следует просто подключить нужную
+библиотеку:
 
-Отобразит <tt>./views/stylesheet.sass</tt>.
+  require 'rdiscount' # или require 'bluecloth'
+  get('/') { markdown :index }
 
-{Опции Sass}[http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options]
-могут быть установлены глобально через конфигурацию Sinatra,
-см. {Опции и Конфигурация}[http://www.sinatrarb.com/configuration.html],
-и переопределены локально.
+=== Haml шаблоны
 
-  set :sass, :style => :compact # :nested - стиль Sass по умолчанию
+Зависимости::         {haml}[http://haml-lang.com/]
+Расширения файлов::   <tt>.haml</tt>
+Пример::              <tt>haml :index, :format => :html5</tt>
 
-  get '/stylesheet.css' do
-    sass :stylesheet, :style => :expanded # переопределен
-  end
+=== Erb шаблоны
 
-=== Scss шаблоны
+Зависимости::         {erubis}[http://www.kuwata-lab.com/erubis/] или erb (включен в Ruby)
+Расширения файлов::   <tt>.erb</tt>, <tt>.rhtml</tt> or <tt>.erubis</tt> (только Erubis)
+Пример::              <tt>erb :index</tt>
 
-<tt>haml</tt> gem/библиотека необходима для рендеринга Scss шаблонов:
+=== Builder шаблоны
 
-  # Вам нужно будет подключить haml или sass в приложении
-  require 'sass'
+Зависимости::         {builder}[http://builder.rubyforge.org/]
+Расширения файлов::   <tt>.builder</tt>
+Пример::              <tt>builder { |xml| xml.em "hi" }</tt>
 
-  get '/stylesheet.css' do
-    scss :stylesheet
-  end
+Блок также используется и для встроенных шаблонов (см. пример).
 
-Отобразит <tt>./views/stylesheet.scss</tt>.
+=== Nokogiri шаблоны
 
-{Опции Scss}[http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options]
-могут быть установлены глобально через конфигурацию Sinatra,
-см. {Опции и Конфигурация}[http://www.sinatrarb.com/configuration.html],
-и переопределены локально.
+Зависимости::         {nokogiri}[http://nokogiri.org/]
+Расширения файлов::   <tt>.nokogiri</tt>
+Пример::              <tt>nokogiri { |xml| xml.em "hi" }</tt>
 
-  set :scss, :style => :compact # :nested - стиль Scss по умолчанию
+Блок также используется и для встроенных шаблонов (см. пример).
 
-  get '/stylesheet.css' do
-    scss :stylesheet, :style => :expanded # переопределен
-  end
+=== Sass шаблоны
 
-=== Less шаблоны
+Зависимости::         {sass}[http://sass-lang.com/]
+Расширения файлов::   <tt>.sass</tt>
+Пример::              <tt>sass :stylesheet, :style => :expanded</tt>
 
-<tt>less</tt> gem/библиотека необходима для рендеринга Less шаблонов:
+=== SCSS шаблоны
 
-  # Вам нужно будет подключить less в приложении
-  require 'less'
+Зависимости::         {sass}[http://sass-lang.com/]
+Расширения файлов::   <tt>.scss</tt>
+Пример::              <tt>scss :stylesheet, :style => :expanded</tt>
 
-  get '/stylesheet.css' do
-    less :stylesheet
-  end
+=== Less шаблоны
 
-Отобразит <tt>./views/stylesheet.less</tt>.
+Зависимости::         {less}[http://www.lesscss.org/]
+Расширения файлов::   <tt>.less</tt>
+Пример::              <tt>less :stylesheet</tt>
 
 === Liquid шаблоны
 
-<tt>liquid</tt> gem/библиотека необходима для рендеринга liquid шаблонов:
-
-  # Вам нужно будет подключить liquid в приложении
-  require 'liquid'
-
-  get '/' do
-    liquid :index
-  end
-
-Отобразит <tt>./views/index.liquid</tt>.
-
-Так как в Liquid шаблонах невозможно вызывать методы из Ruby (кроме +yield+),
-то вы почти всегда будете передавать локальные переменные:
+Зависимости::         {liquid}[http://www.liquidmarkup.org/]
+Расширения файлов::   <tt>.liquid</tt>
+Пример::              <tt>liquid :index, :locals => { :key => 'value' }</tt>
 
-  liquid :index, :locals => { :key => 'value' }
+Так как в Liquid шаблонах невозможно вызывать методы из Ruby (кроме yield), то
+вы почти всегда будете передавать в шаблон локальные переменные.
 
 === Markdown шаблоны
 
-<tt>rdiscount</tt> gem/библиотека необходима для рендеринга Markdown шаблонов:
-
-  # Вам нужно будет подключить rdiscount в приложении
-  require 'rdiscount'
-  
-  get '/' do
-    markdown :index
-  end
-
-Отобразит <tt>./views/index.markdown</tt> (+md+ и +mkd+ также являются допустимыми файловыми
-расширениями).
+Зависимости::          {rdiscount}[https://github.com/rtomayko/rdiscount], {redcarpet}[https://github.com/tanoku/redcarpet], {bluecloth}[http://deveiate.org/projects/BlueCloth], {kramdown}[http://kramdown.rubyforge.org/] или {maruku}[http://maruku.rubyforge.org/]
+Расширения файлов::   <tt>.markdown</tt>, <tt>.mkd</tt> and <tt>.md</tt>
+Пример::              <tt>markdown :index, :layout_engine => :erb</tt>
 
 В Markdown невозможно вызывать методы или передавать локальные переменные.
-Следовательно, вам, скорее всего, придется использовать этот шаблон совместно с другим
-движком рендеринга:
+Следовательно, вам, скорее всего, придется использовать этот шаблон совместно
+с другим шаблонизатором:
 
   erb :overview, :locals => { :text => markdown(:introduction) }
 
@@ -408,57 +385,20 @@ Thin - это более производительный и функциона
   %h1 Hello From Haml!
   %p= markdown(:greetings)
 
-Вы не можете вызывать Ruby из Markdown, соответственно, вы не можете использовать
-лэйаут-шаблоны (layouts) на Markdown. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута (разметки) с помощью опции <tt>:layout_engine</tt>:
-
-  get '/' do
-    markdown :index, :layout_engine => :erb
-  end
-
-Отобразит <tt>./views/index.md</tt> с <tt>./views/layout.erb</tt> в качестве
-лэйаута (разметки).
-
-Также вы можете задать такие опции рендеринга глобально:
-
-  set :markdown, :layout_engine => :haml, :layout => :post
-
-  get '/' do
-    markdown :index
-  end
-
-Отобразит <tt>./views/index.md</tt> (и любой другой шаблон на Markdown) с
-<tt>./views/post.haml</tt> в качестве лэйаута (разметки).
-
-Также возможно обрабатывать Markdown с помощью BlueCloth, а не RDiscount:
-
-  require 'bluecloth'
-
-  Tilt.register 'markdown', BlueClothTemplate
-  Tilt.register 'mkd',      BlueClothTemplate
-  Tilt.register 'md',       BlueClothTemplate
-
-  get '/' do
-    markdown :index
-  end
-
-Отобразит <tt>./views/index.md</tt> с помощью BlueCloth.
+Вы не можете вызывать Ruby из Markdown, соответственно, вы не можете
+использовать лэйауты на Markdown. Тем не менее, есть возможность использовать
+один шаблонизатор для отображения шаблона, а другой для лэйаута с помощью
+опции <tt>:layout_engine</tt>.
 
 === Textile шаблоны
 
-<tt>RedCloth</tt> gem/библиотека необходима для рендеринга Textile шаблонов:
+Зависимости::         {RedCloth}[http://redcloth.org/]
+Расширения файлов::   <tt>.textile</tt>
+Пример::              <tt>textile :index, :layout_engine => :erb</tt>
 
-  # Вам нужно будет подключить redcloth в приложении
-  require 'redcloth'
-
-  get '/' do
-    textile :index
-  end
-
-Отобразит <tt>./views/index.textile</tt>.
-
-В Textile невозможно вызывать методы или передавать локальные переменные. Следовательно, вам, скорее всего,
-придется использовать этот шаблон совместно с другим движком рендеринга:
+В Textile невозможно вызывать методы или передавать локальные переменные.
+Следовательно, вам, скорее всего, придется использовать этот шаблон совместно с
+другим шаблонизатором:
 
   erb :overview, :locals => { :text => textile(:introduction) }
 
@@ -467,43 +407,20 @@ Thin - это более производительный и функциона
   %h1 Hello From Haml!
   %p= textile(:greetings)
 
-Вы не можете вызывать Ruby из Textile, соответственно, вы не можете использовать
-лэйаут-шаблоны на Textile. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута (разметки) с помощью опции <tt>:layout_engine</tt>:
-
-  get '/' do
-    textile :index, :layout_engine => :erb
-  end
-
-Отобразит <tt>./views/index.textile</tt> с <tt>./views/layout.erb</tt> в качестве
-лэйаута (разметки).
-
-Также вы можете задать такие опции рендеринга глобально:
-
-  set :textile, :layout_engine => :haml, :layout => :post
-
-  get '/' do
-    textile :index
-  end
-
-Отобразит <tt>./views/index.textile</tt> (и любой другой шаблон на Textile) с
-<tt>./views/post.haml</tt> в качестве лэйаута (разметки).
+Вы не можете вызывать Ruby из Textile, соответственно, вы не можете
+использовать лэйауты на Textile. Тем не менее, есть возможность использовать
+один шаблонизатор для отображения шаблона, а другой для лэйаута с помощью
+опции <tt>:layout_engine</tt>.
 
 === RDoc шаблоны
 
-<tt>rdoc</tt> gem/библиотека необходима для рендеринга RDoc шаблонов:
-
-  # Вам нужно будет подключить rdoc/markup/to_html в приложении
-  require 'rdoc/markup/to_html'
-
-  get '/' do
-    rdoc :index
-  end
-
-Отобразит <tt>./views/index.rdoc</tt>.
+Зависимости::         {rdoc}[http://rdoc.rubyforge.org/]
+Расширения файлов::   <tt>.rdoc</tt>
+Пример::              <tt>textile :README, :layout_engine => :erb</tt>
 
-В RDoc невозможно вызывать методы или передавать локальные переменные. Следовательно, вам, скорее всего,
-придется использовать этот шаблон совместно с другим движком рендеринга:
+В RDoc невозможно вызывать методы или передавать локальные переменные.
+Следовательно, вам, скорее всего, придется использовать этот шаблон совместно с
+другим шаблонизатором:
 
   erb :overview, :locals => { :text => rdoc(:introduction) }
 
@@ -512,112 +429,61 @@ Thin - это более производительный и функциона
   %h1 Hello From Haml!
   %p= rdoc(:greetings)
 
-Вы не можете вызывать Ruby из RDoc, соответственно, вы не можете использовать
-лэйаут-шаблоны на RDoc. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута (разметки) с помощью опции <tt>:layout_engine</tt>:
-
-  get '/' do
-    rdoc :index, :layout_engine => :erb
-  end
-
-Отобразит <tt>./views/index.rdoc</tt> с <tt>./views/layout.erb</tt> в качестве
-лэйаута (разметки).
-
-Также вы можете задать такие опции рендеринга глобально:
-
-  set :rdoc, :layout_engine => :haml, :layout => :post
-
-  get '/' do
-    rdoc :index
-  end
-
-Отобразит <tt>./views/index.rdoc</tt> (и любой другой шаблон на RDoc) с
-<tt>./views/post.haml</tt> в качестве лэйаута (разметки).
+Вы не можете вызывать Ruby из RDoc, соответственно, вы не можете
+использовать лэйауты на RDoc. Тем не менее, есть возможность использовать
+один шаблонизатор для отображения шаблона, а другой для лэйаута с помощью
+опции <tt>:layout_engine</tt>.
 
 === Radius шаблоны
 
-<tt>radius</tt> gem/библиотека необходима для рендеринга Radius шаблонов:
-
-  # Вам нужно будет подключить radius в приложении
-  require 'radius'
-
-  get '/' do
-    radius :index
-  end
-
-Отобразит <tt>./views/index.radius</tt>.
-
-Так как в Radius шаблоне невозможно вызывать методы из Ruby (кроме +yield+), 
-то вы почти всегда будете передавать локальные переменные:
+Зависимости::         {radius}[http://radius.rubyforge.org/]
+Расширения файлов::   <tt>.radius</tt>
+Пример::              <tt>radius :index, :locals => { :key => 'value' }</tt>
 
-  radius :index, :locals => { :key => 'value' }
+Так как в Radius шаблонах невозможно вызывать методы из Ruby напрямую, то
+вы почти всегда будете передавать в шаблон локальные переменные.
 
 === Markaby шаблоны
 
-<tt>markaby</tt> gem/библиотека необходима для рендеринга Markaby шаблонов:
-
-  # Вам нужно будет подключить markaby в приложении
-  require 'markaby'
-
-  get '/' do
-    markaby :index
-  end
-
-Отобразит <tt>./views/index.mab</tt>.
-
-Вы также можете использовать внутристроковые Markaby шаблоны:
+Зависимости::         {markaby}[http://markaby.github.com/]
+Расширения файлов::   <tt>.mab</tt>
+Пример::              <tt>markaby { h1 "Welcome!" }</tt>
 
-  get '/' do
-    markaby { h1 "Welcome!" }
-  end
+Блок также используется и для встроенных шаблонов (см. пример).
 
 === Slim шаблоны
 
-<tt>slim</tt> gem/библиотека необходима для рендеринга slim шаблонов:
-
-  # Вам нужно будет подключить slim в приложении
-  require 'slim'
-
-  get '/' do
-    slim :index
-  end
-
-Отобразит <tt>./views/index.slim</tt>.
+Зависимости::         {slim}[http://slim-lang.com/]
+Расширения файлов::   <tt>.slim</tt>
+Пример::              <tt>slim :index</tt>
 
 === Creole шаблоны
 
-<tt>creole</tt> gem/библиотека необходима для рендеринга creole шаблонов:
+Зависимости::         {creole}[https://github.com/minad/creole]
+Расширения файлов::   <tt>.creole</tt>
+Пример::              <tt>creole :wiki, :layout_engine => :erb</tt>
 
-  # Вам нужно будет подключить creole в приложении
-  require 'creole'
+В Creole невозможно вызывать методы или передавать локальные переменные.
+Следовательно, вам, скорее всего, придется использовать этот шаблон совместно с
+другим шаблонизатором:
 
-  get '/' do
-    creole :index
-  end
-
-Отобразит <tt>./views/index.creole</tt>.
-
-=== CoffeeScript шаблоны
+  erb :overview, :locals => { :text => creole(:introduction) }
 
-Вам понадобится <tt>coffee-script</tt> gem/библиотека и что-то <b>одно</b> из следующего списка,
-чтобы запускать JavaScript:
+Заметьте, что вы можете вызывать метод +creole+ из других шаблонов:
 
-* +node+ (из Node.js);
-* вы можете использовать OS X (в которой есть встроенные средства для выполнения JavaScript);
-* +therubyracer+ gem/библиотека.
-
-Подробнее смотрите на {странице проекта}[http://github.com/josh/ruby-coffee-script].
-
-Таким образом, вы можете использовать CoffeeScript шаблоны.
+  %h1 Hello From Haml!
+  %p= creole(:greetings)
 
-  # Вам нужно будет подключить coffee-script gem в приложении
-  require 'coffee-script'
+Вы не можете вызывать Ruby из Creole, соответственно, вы не можете
+использовать лэйауты на Creole. Тем не менее, есть возможность использовать
+один шаблонизатор для отображения шаблона, а другой для лэйаута с помощью
+опции <tt>:layout_engine</tt>.
 
-  get '/application.js' do
-    coffee :application
-  end
+=== CoffeeScript шаблоны
 
-Отобразит <tt>./views/application.coffee</tt>.
+Зависимости::         {coffee-script}[https://github.com/josh/ruby-coffee-script] и {способ запускать javascript}[https://github.com/sstephenson/execjs/blob/master/README.md#readme]
+Расширения файлов::   <tt>.coffee</tt>
+Пример::              <tt>coffee :index</tt>
 
 === Встроенные шаблоны
 
@@ -625,7 +491,7 @@ Thin - это более производительный и функциона
     haml '%div.title Hello World'
   end
 
-Отобразит строку встроенного шаблона.
+Отобразит встроенный шаблон, переданный строкой.
 
 === Доступ к переменным в шаблонах
 
@@ -641,7 +507,7 @@ Thin - это более производительный и функциона
 
   get '/:id' do
     foo = Foo.find(params[:id])
-    haml '%h1= foo.name', :locals => { :foo => foo }
+    haml '%h1= bar.name', :locals => { :bar => foo }
   end
 
 Это обычный подход, когда шаблоны рендерятся как части других шаблонов.
@@ -686,8 +552,9 @@ Thin - это более производительный и функциона
   end
 
 Если шаблон с именем "layout" существует, то он будет использоваться каждый раз
-при рендеринге. Вы можете отключать лэйаут (разметку) в каждом конкретном случае с помощью
-<tt>:layout => false</tt> или отключить его для всего приложения, например, так: <tt>set :haml, :layout => false</tt>:
+при рендеринге. Вы можете отключать лэйаут в каждом конкретном случае с помощью
+<tt>:layout => false</tt> или отключить его для всего приложения, например, так:
+<tt>set :haml, :layout => false</tt>:
 
   get '/' do
     haml :index, :layout => !request.xhr?
@@ -782,7 +649,7 @@ Thin - это более производительный и функциона
 === Использование сессий
 
 Сессия используется, чтобы сохранять состояние между запросами. Если эта опция
-включена, то у вас будет один хэш сессии на одну пользовательскую сессию:
+включена, то у вас будет один хеш сессии на одну пользовательскую сессию:
 
   enable :sessions
 
@@ -799,7 +666,7 @@ Thin - это более производительный и функциона
 сохранение больших объемов данных увеличит ваш трафик). В таком случае вы
 можете использовать альтернативную Rack "прослойку" (middleware), реализующую
 механизм сессий. Для этого *не надо* вызывать <tt>enable :sessions</tt>,
-вместо этого следует подключить ее также как и любую другую "прослойку":
+вместо этого следует подключить ее так же, как и любую другую "прослойку":
 
   use Rack::Session::Pool, :expire_after => 2592000
 
@@ -815,11 +682,11 @@ Thin - это более производительный и функциона
 ключом. Секретный ключ генерируется Sinatra. Тем не менее, так как этот
 ключ будет меняться с каждым запуском приложения, вы, возможно, захотите
 установить ключ вручную, чтобы у всех экземпляров вашего приложения
-быд один и тот же ключ:
+был один и тот же ключ:
 
   set :session_secret, 'super secret'
 
-Если вы хотите больше настроек для сессий, вы можете задать их, передав хэш опций в параметр +sessions+:
+Если вы хотите больше настроек для сессий, вы можете задать их, передав хеш опций в параметр +sessions+:
 
   set :sessions, :domain => 'foo.com'
 
@@ -913,7 +780,7 @@ Thin - это более производительный и функциона
   get '/foo' do
     status 418
     headers \
-      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN"
+      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN",
       "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
     body "I'm a tea pot!"
   end
@@ -949,7 +816,9 @@ Thin - это более производительный и функциона
 Когда вы используете <tt>send_file</tt> или статические файлы, у вас могут быть mime-типы, которые Sinatra
 не понимает по умолчанию. Используйте +mime_type+ для их регистрации по расширению файла:
 
-  mime_type :foo, 'text/foo'
+  configure do
+    mime_type :foo, 'text/foo'
+  end
 
 Вы также можете использовать это в +content_type+ методе-помощнике:
 
@@ -997,9 +866,9 @@ Thin - это более производительный и функциона
 
   redirect to('/bar?sum=42')
 
-Либо используйте сессию:
+либо используйте сессию:
 
-  enable :session
+  enable :sessions
 
   get '/foo' do
     session[:secret] = 'foo'
@@ -1034,9 +903,9 @@ Thin - это более производительный и функциона
     expires 500, :public, :must_revalidate
   end
 
-Чтобы как следует использовать кэши, вам следует подумать об использовании
+Чтобы как следует использовать кэширование, вам следует подумать об использовании
 +etag+ и +last_modified+. Рекомендуется использовать эти методы-помощники *до*
-выполнения "тяжелых" вычислений, так как они немедленно отправят ответ клиенту,
+выполнения ресурсоемких вычислений, так как они немедленно отправят ответ клиенту,
 если текущая версия уже есть в их кэше:
 
   get '/article/:id' do
@@ -1066,6 +935,9 @@ Thin - это более производительный и функциона
     "hello"
   end
 
+Используйте опцию <tt>:static_cache_control</tt> (см. ниже), чтобы
+добавить заголовок <tt>Cache-Control</tt> к статическим файлам.
+
 === Отправка файлов
 
 Для отправки файлов пользователю вы можете использовать метод <tt>send_file</tt>:
@@ -1109,29 +981,33 @@ Thin - это более производительный и функциона
 
   # приложение запущено на http://example.com/example
   get '/foo' do
-    request.body              # тело запроса, посланное клиентом (см. ниже)
-    request.scheme            # "http"
-    request.script_name       # "/example"
-    request.path_info         # "/foo"
-    request.port              # 80
-    request.request_method    # "GET"
-    request.query_string      # ""
-    request.content_length    # длина тела запроса
-    request.media_type        # медиатип тела запроса
-    request.host              # "example.com"
-    request.get?              # true (есть аналоги для других методов HTTP)
-    request.form_data?        # false
-    request["SOME_HEADER"]    # значение заголовка SOME_HEADER
-    request.referrer          # источник запроса клиента либо '/'
-    request.user_agent        # user agent (используется для :agent условия)
-    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
+    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.scheme              # "http"
+    request.script_name         # "/example"
+    request.path_info           # "/foo"
+    request.port                # 80
+    request.request_method      # "GET"
+    request.query_string        # ""
+    request.content_length      # длина тела запроса
+    request.media_type          # медиатип тела запроса
+    request.host                # "example.com"
+    request.get?                # true (есть аналоги для других методов HTTP)
+    request.form_data?          # false
+    request["SOME_HEADER"]      # значение заголовка SOME_HEADER
+    request.referrer            # источник запроса клиента либо '/'
+    request.user_agent          # user agent (используется для :agent условия)
+    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
   end
 
 Некоторые опции, такие как <tt>script_name</tt> или <tt>path_info</tt> доступны для изменения:
@@ -1175,7 +1051,7 @@ Thin - это более производительный и функциона
     puts "could be #{file}"
   end
 
-Это не очень-то полезный пример. Зато полезен тот факт, что вы можете переопределить
+Это не слишком полезный пример. Зато полезен тот факт, что вы можете переопределить
 этот метод, чтобы использовать свой собственный механизм поиска. Например, если вы
 хотите, чтобы можно было использовать несколько директорий с шаблонами:
 
@@ -1201,12 +1077,12 @@ Thin - это более производительный и функциона
 
 Вы можете легко вынести этот код в расширение и поделиться им с остальными!
 
-Заметьте, что <tt>find_template</tt не проверяет, существует ли файл на самом деле,
+Заметьте, что <tt>find_template</tt> не проверяет, существует ли файл на самом деле,
 а вызывает заданный блок для всех возможных путей. Дело тут не в производительности,
 дело в том, что +render+ вызовет +break+, как только файл не будет найден.
 Содержимое и местонахождение шаблонов будет закэшировано, если приложение запущено не
 в режиме разработки (set :environment, :development). Вы должны помнить об этих нюансах, 
-если пишите по-настоящему "сумашедший" метод.
+если пишите по-настоящему "сумасшедший" метод.
 
 == Конфигурация
 
@@ -1255,90 +1131,97 @@ Thin - это более производительный и функциона
 
 === Доступные настройки
 
-[absolute_redirects]  если отключено, то Sinatra будет позволять использование
-                      относительных перенаправлений, тем не менее, Sinatra перестанет
-                      соответствовать RFC 2616 (HTTP 1.1), который разрешает только
-                      абсолютные перенаправления.
+[absolute_redirects]   если отключено, то Sinatra будет позволять использование
+                       относительных перенаправлений, но при этом перестанет
+                       соответствовать RFC 2616 (HTTP 1.1), который разрешает только
+                       абсолютные перенаправления.
+
+                       Включайте эту опцию, если ваше приложение работает за обратным прокси,
+                       который настроен не совсем корректно. Обратите внимание, метод +url+
+                       все равно будет генерировать абсолютные URL, если вы не передадите
+                       +false+ вторым аргументом.
 
-                      Включайте эту опцию, если ваше приложение работает за обратным прокси,
-                      который настроен не совсем корректно. Обратите внимание, метод +url+
-                      все равно будет генерировать абсолютные URL, если вы не передадите
-                      +false+ вторым аргументом.
+                       Отключено по умолчанию.
 
-                      Отключено по умолчанию.
+[add_charsets]         mime-типы, к которым метод <tt>content_type</tt> будет автоматически
+                       добавлять информацию о кодировке.
 
-[add_charsets]        mime-типы, к которым метод <tt>content_type</tt> будет автоматически
-                      добавлять информацию о кодировке.
+                       Вам следует добавлять значения к этой опции вместо ее переопределения:
 
-                      Вам следует добавлять значения к этой опции вместо ее переопределения:
+                         settings.add_charsets << "application/foobar"
 
-                        settings.add_charsets << "application/foobar"
+[app_file]             главный файл приложения, используется для определения корневой директории
+                       проекта, директорий с шаблонами и статическими файлами, вложенных шаблонов.
 
-[app_file]            главный файл приложения, используется для определения корневой директории
-                      проекта, директорий с шаблонами и статическими файлами, вложенных шаблонов.
+[bind]                 используемый IP-адрес (по умолчанию: 0.0.0.0). Используется только
+                       встроенным сервером.
 
-[bind]                используемый IP-адрес (по умолчанию: 0.0.0.0). Используется только
-                      встроенным сервером.
+[default_encoding]     кодировка, если неизвестна (по умолчанию: <tt>"utf-8"</tt>).
 
-[default_encoding]    кодировка, если неизвестна (по умолчанию: <tt>"utf-8"</tt>).
+[dump_errors]          отображать ошибки в логе.
 
-[dump_errors]         отображать ошибки в логе.
+[environment]          текущее окружение, по умолчанию, значение <tt>ENV['RACK_ENV']</tt>
+                       или <tt>"development"</tt>, если <tt>ENV['RACK_ENV']</tt> не доступна.
 
-[environment]         текущее окружение, по умолчанию, значение <tt>ENV['RACK_ENV']</tt>
-                      или <tt>"development"</tt>, если <tt>ENV['RACK_ENV']</tt> не доступна.
+[logging]              использовать логер.
 
-[logging]             использовать логер.
+[lock]                 создает блокировку для каждого запроса, которая гарантирует обработку
+                       только одного запроса в текущий момент времени в Ruby процессе.
 
-[lock]                создает блокировку для каждого запроса, которая гарантирует обработку
-                      только одного запроса в текущий момент времени в Ruby процессе.
+                       Включайте, если ваше приложение не потоко-безопасно (thread-safe).
+                       Отключено по умолчанию.
 
-                      Включайте, если ваше приложение не потоко-безопасно (thread-safe).
-                      Отключено по умолчанию.
+[method_override]      использовать "магический" параметр <tt>_method</tt>, чтобы позволить
+                       использование PUT/DELETE форм в браузерах, которые не поддерживают
+                       эти методы.
 
-[method_override]     использовать "магический" параметр <tt>_method</tt>, чтобы позволить
-                      использование PUT/DELETE форм в браузерах, которые не поддерживают
-                      эти методы.
+[port]                 порт, на котором будет работать сервер. Используется только
+                       встроенным сервером.
 
-[port]                порт, на котором будет работать сервер. Используется только
-                      встроенным сервером.
+[prefixed_redirects]   добавлять или нет параметр <tt>request.script_name</tt> к редиректам,
+                       если не задан абсолютный путь. Таким образом,  <tt>redirect '/foo'</tt>
+                       будет вести себя как <tt>redirect to('/foo')</tt>. Отключено по умолчанию.
 
-[prefixed_redirects]  добавлять или нет параметр <tt>request.script_name</tt> к редиректам,
-                      если не задан абсолютный путь. Таким образом,  <tt>redirect '/foo'</tt>
-                      будет вести себя как <tt>redirect to('/foo')</tt>. Отключено по умолчанию.
+[public_folder]        директория, откуда будут раздаваться статические файлы.
 
-[public]              директория, откуда будут раздаваться статические файлы.
+[reload_templates]     перезагружать или нет шаблоны на каждый запрос.
+                       Включено в режиме разработки.
 
-[reload_templates]    перезагружать или нет шаблоны на каждый запрос.
-                      Включено в режиме разработки.
+[root]                 корневая директория проекта.
 
-[root]                корневая директория проекта.
+[raise_errors]         выбрасывать исключения (будет останавливать приложение).
 
-[raise_errors]        выбрасывать исключения (будет останавливать приложение).
+[run]                  если включено, Sinatra будет самостоятельно запускать веб-сервер.
+                       Не включайте, если используете rackup или аналогичные средства.
 
-[run]                 если включено, Sinatra будет самостоятельно запускать веб-сервер.
-                      Не включайте, если используете rackup или аналогичные средства.
+[running]              работает ли сейчас встроенный сервер?
+                       Не меняйте эту опцию!
 
-[running]             работает ли сейчас встроенный сервер?
-                      Не меняйте эту опцию!
+[server]               сервер или список серверов, которые следует использовать в качестве
+                       встроенного сервера. По умолчанию: ['thin', 'mongrel', 'webrick'],
+                       порядок задает приоритет.
 
-[server]              сервер или список серверов, которые следует использовать в качестве
-                      встроенного сервера. По умолчанию: ['thin', 'mongrel', 'webrick'],
-                      порядок задает приоритет.
+[sessions]             включить сессии на основе кук (cookie).
 
-[sessions]            включить сессии на основе кук (cookie).
+[show_exceptions]      показывать исключения/стек вызовов (stack trace) в браузере.
 
-[show_exceptions]     показывать исключения/стек вызовов (stack trace) в браузере.
+[static]               должна ли Sinatra осуществлять раздачу статических файлов.
+                       Отключите, когда используете какой-либо веб-сервер для этой цели.
+                       Отключение значительно улучшит производительность приложения.
+                       По умолчанию включено в классических и отключено в модульных
+                       приложениях.
 
-[static]              должна ли Sinatra осуществлять раздачу статических файлов.
-                      Отключите, когда используете какой-либо веб-сервер для этой цели.
-                      Отключение значительно улучшит производительность приложения.
-                      Включено по умолчанию.
+[static_cache_control] Когда Sinatra отдает статические файлы, используйте эту опцию,
+                       чтобы добавить им заголовок <tt>Cache-Control</tt>. Для этого
+                       используется метод-помощник +cache_control+. По умолчанию отключено.
+                       Используйте массив, когда надо задать несколько значений:
+                       <tt>set :static_cache_control, [:public, :max_age => 300]</tt>
 
 [views]               директория с шаблонами.
 
 == Обработка ошибок
 
-Обработчики ошибок исполняются в том же контексте, что и маршруты, +before+-фильтры, а это означает, что всякие
+Обработчики ошибок исполняются в том же контексте, что и маршруты, и +before+-фильтры, а это означает, что всякие
 прелести вроде <tt>haml</tt>, <tt>erb</tt>, <tt>halt</tt> и т.д. доступны и им.
 
 === Not Found
@@ -1416,8 +1299,8 @@ HTTP запросами/ответами для предоставления р
 
 Семантика +use+ идентична той, что определена для
 Rack::Builder[http://rack.rubyforge.org/doc/classes/Rack/Builder.html] DSL
-(чаще всего используется в rackup файлах). Например, +use+ метод принимает
-множественные переменные, также как и блоки:
+(чаще всего используется в rackup файлах). Например, метод +use+ принимает
+как множественные переменные, так и блоки:
 
   use Rack::Auth::Basic do |username, password|
     username == 'admin' && password == 'secret'
@@ -1428,10 +1311,16 @@ Rack распространяется с различными стандартн
 многие из этих компонентов автоматически, основываясь на конфигурации, чтобы вам не приходилось
 подключать (+use+) их вручную.
 
+Вы можете найти полезные прослойки в
+{rack}[https://github.com/rack/rack/tree/master/lib/rack],
+{rack-contrib}[https://github.com/rack/rack-contrib#readme],
+{CodeRack}[http://coderack.org/] или в
+{Rack wiki}[https://github.com/rack/rack/wiki/List-of-Middleware].
+
 == Тестирование
 
 Тесты для Sinatra приложений могут быть написаны с помощью библиотек, фреймворков, поддерживающих
-тестирование Rack. {Rack::Test}[http://gitrdoc.com/brynary/rack-test] рекомендован:
+тестирование Rack. {Rack::Test}[http://rdoc.info/github/brynary/rack-test/master/frames] рекомендован:
 
   require 'my_sinatra_app'
   require 'test/unit'
@@ -1460,19 +1349,18 @@ Rack распространяется с различными стандартн
     end
   end
 
-Обратите внимание: Встроенные модуль Sinatra::Test и класс Sinatra::TestHarness являются
-устаревшими, начиная с релиза 0.9.2.
-
 == Sinatra::Base — "прослойки", библиотеки и модульные приложения
 
-Описание своего приложения самым простейшим способом (с помощью DSL верхнего уровня, как в примерах выше)
-работает отлично для крохотных приложений, но имеет множество недостатков, когда надо создать компоненты, такие как
-Rack middleware ("прослойки"), Rails metal, простые библиотеки с серверными компонентами, расширения Sinatra.
+Описание своего приложения самым простейшим способом (с помощью DSL верхнего уровня,
+как в примерах выше) отлично работает для крохотных приложений. Тем не менее,
+такой метод имеет множество недостатков при создании компонентов, таких как
+Rack middleware ("прослоек"), Rails metal, простых библиотек с серверными компонентами,
+расширений Sinatra.
 
 DSL верхнего уровня "загрязняет" пространство имен <tt>Object</tt> и подразумевает стиль конфигурации
-микро-приложения (например, единый файл приложения, ./public и
-./views директории, создание логов, страницу деталей об исключениях 
-и т.д.). И тут на помощь приходит Sinatra::Base:
+микро-приложения (например, единый файл приложения, <tt>./public</tt> и
+<tt>./views</tt> директории, логирование, страницу деталей об исключениях
+и т.д.). И тут на помощь приходит <tt>Sinatra::Base</tt>:
 
   require 'sinatra/base'
 
@@ -1485,31 +1373,31 @@ DSL верхнего уровня "загрязняет" пространств
     end
   end
 
-Методы, доступные Sinatra::Base подклассам идентичны тем, что доступны
+Методы, доступные <tt>Sinatra::Base</tt> подклассам идентичны тем, что доступны
 в DSL верхнего уровня. Большинство приложений верхнего уровня могут быть
-конвертированы в Sinatra::Base компоненты с помощью двух модификаций:
+конвертированы в <tt>Sinatra::Base</tt> компоненты с помощью двух модификаций:
 
 * Вы должны подключать <tt>sinatra/base</tt> вместо +sinatra+,
-  иначе все методы предоставляемые Sinatra будут импортированы в глобальное пространство имен.
-* Поместите все маршруты, обработчики ошибок, фильтры и опции в подкласс Sinatra::Base.
+  иначе все методы, предоставляемые Sinatra, будут импортированы в глобальное пространство имен.
+* Поместите все маршруты, обработчики ошибок, фильтры и опции в подкласс <tt>Sinatra::Base</tt>.
 
 <tt>Sinatra::Base</tt> — это чистый лист. Большинство опций, включая встроенный сервер, по умолчанию отключены.
-Смотрите {Опции и Конфигурация}[http://www.sinatrarb.com/configuration.html] для детальной информации
+Смотрите {Опции и конфигурация}[http://www.sinatrarb.com/configuration.html] для детальной информации
 об опциях и их поведении.
 
 === Модульные приложения против классических
 
-Вопреки всеобщему убеждению в классическом стиле (самом простом) нет ничего плохого.
+Вопреки всеобщему убеждению, в классическом стиле (самом простом) нет ничего плохого.
 Если этот стиль подходит вашему приложению, вы не обязаны переписывать его в модульное
 приложение.
 
 У классического стиля есть всего два недостатка относительно модульного:
 
-* У вас может быть только одно приложение Sinatra на Ruby процесс. Если вы планируете
+* У вас может быть только одно приложение Sinatra на один Ruby процесс. Если вы планируете
   использовать больше, то переключайтесь на модульный стиль.
 
 * Приложения, использующие классический стиль, добавляют методы к Object. Если вы
-  планируете поставлять свое приложение в виде библиотеки/gem, то переключайтесь
+  планируете поставлять свое приложение в виде библиотеки/gem, то переходите
   на модульный стиль.
 
 Не существует причин, по которым вы не могли бы смешивать модульный и классический стили.
@@ -1518,11 +1406,12 @@ DSL верхнего уровня "загрязняет" пространств
 
   Опция               Классический            Модульный
 
-  app_file            файл с приложением      nil
+  app_file            файл с приложением      файл с подклассом Sinatra::Base
   run                 $0 == app_file          false
   logging             true                    false
   method_override     true                    false
   inline_templates    true                    false
+  static              true                    false
 
 
 === Запуск модульных приложений
@@ -1585,7 +1474,7 @@ Rack-совместимый сервер приложений.
 
 === Использование Sinatra в качестве "прослойки"
 
-Не только сам Sinatra может использовать "прослойки" Rack, но и любое Sinatra приложение
+Не только сама Sinatra может использовать "прослойки" Rack, но и любое Sinatra приложение
 само может быть добавлено к любому Rack endpoint в качестве "прослойки". Этим endpoint (конечной точкой)
 может быть другое Sinatra приложение, или приложение, основанное на Rack (Rails/Ramaze/Camping/...):
 
@@ -1597,7 +1486,7 @@ Rack-совместимый сервер приложений.
     get('/login') { haml :login }
     
     post('/login') do
-      if params[:name] = 'admin' and params[:password] = 'admin'
+      if params[:name] == 'admin' && params[:password] == 'admin'
         session['user_name'] = params[:name]
       else
         redirect '/login'
@@ -1618,6 +1507,48 @@ Rack-совместимый сервер приложений.
     get('/') { "Hello #{session['user_name']}." }
   end
 
+=== Создание приложений "на лету"
+
+Иногда требуется создавать Sinatra приложения "на лету" (например,
+из другого приложения). Это возможно с помощью <tt>Sinatra.new</tt>:
+
+  require 'sinatra/base'
+  my_app = Sinatra.new { get('/') { "hi" } }
+  my_app.run!
+
+Этот метод может принимать аргументом приложение, от которого
+следует наследоваться:
+
+  # config.ru
+  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
+
+Это особенно полезно для тестирования расширений Sinatra и при
+использовании Sinatra внутри вашей библиотеки.
+
+Благодаря этому, использовать Sinatra как "прослойку" очень просто:
+
+  require 'sinatra/base'
+
+  use Sinatra do
+    get('/') { ... }
+  end
+
+  run RailsProject::Application
+
+
 == Области видимости и привязка
 
 Текущая область видимости определяет методы и переменные, доступные
@@ -1625,11 +1556,11 @@ Rack-совместимый сервер приложений.
 
 === Область видимости приложения / класса
 
-Любое Sinatra приложение соответствует подклассу Sinatra::Base. Если вы 
+Любое Sinatra приложение соответствует подклассу <tt>Sinatra::Base</tt>. Если вы
 используете DSL верхнего уровня (<tt>require 'sinatra'</tt>), то этим классом будет 
-Sinatra::Application, иначе это будет подкласс, который вы создали вручную.
+<tt>Sinatra::Application</tt>, иначе это будет подкласс, который вы создали вручную.
 На уровне класса вам будут доступны такие методы, как +get+ или +before+, но вы
-не сможете иметь доступ к объектам +request+ или +session+, так как существует
+не сможете получить доступ к объектам +request+ или +session+, так как существует
 только один класс приложения для всех запросов.
 
 Опции, созданные с помощью +set+, являются методами уровня класса:
@@ -1649,7 +1580,8 @@ Sinatra::Application, иначе это будет подкласс, котор
 * тела вашего класса приложения;
 * методов, определенных расширениями;
 * блока, переданного в +helpers+;
-* блоков, использованных как значения для +set+.
+* блоков, использованных как значения для +set+;
+* блока, переданного в <tt>Sinatra.new</tt>.
 
 Вы можете получить доступ к объекту области видимости (классу приложения) следующими способами:
 
@@ -1679,9 +1611,9 @@ Sinatra::Application, иначе это будет подкласс, котор
     end
   end
 
-У вас будет область видимости запроса внутри:
+У вас будет область видимости запроса в:
 
-* get/head/post/put/delete/options блоков;
+* get/head/post/put/delete/options блоках;
 * before/after фильтрах;
 * методах-помощниках;
 * шаблонах/отображениях.
@@ -1689,10 +1621,10 @@ Sinatra::Application, иначе это будет подкласс, котор
 === Область видимости делегирования
 
 Область видимости делегирования просто перенаправляет методы в область видимости класса.
-Однако, оно не полностью на 100% ведет себя как область видимости класса,
-так как у вас нету привязки к классу: только методы, явно помеченные для
-делегирования, будут доступны, а переменных/состояний области видимости класса
-не будет (иначе говоря, у вас будет другой +self+ объект). Вы можете
+Однако, она не полностью ведет себя как область видимости класса, так как у вас нет
+привязки к классу. Только методы, явно помеченные для делегирования, будут доступны,
+а переменных/состояний области видимости класса не будет (иначе говоря,
+у вас будет другой +self+ объект). Вы можете
 непосредственно добавить методы делегирования, используя
 <tt>Sinatra::Delegator.delegate :method_name</tt>.
 
@@ -1731,7 +1663,7 @@ Sinatra приложения могут быть запущены напряму
 [ Ruby 1.9.2 ]
   1.9.2 поддерживается и рекомендована к использованию. Заметьте, что Radius и Markaby
   пока несовместимы с 1.9.2. Не используйте 1.9.2p0, известно, что эта
-  версия весьма не стабильна при использовании Sinatra.
+  версия весьма нестабильна при использовании Sinatra.
 
 [ Rubinius ]
   Rubinius официально поддерживается (Rubinius >= 1.2.3), всё, включая все
@@ -1742,9 +1674,12 @@ Sinatra приложения могут быть запущены напряму
   использованием альтернативных шаблонов. Тем не менее, если вы выбираете
   JRuby, то, пожалуйста, посмотрите на JRuby Rack-сервера, так как Thin не
   поддерживается полностью на JRuby. Поддержка расширений на C в JRuby все
-  еще экспериментальная, что на данный момент затрагивает только RDiscount.
+  еще экспериментальная, что на данный момент затрагивает только RDiscount и
+  Redcarpet.
 
-<b>Ruby 1.8.6 больше не поддерживается.</b>
+<b>Ruby 1.8.6 больше не поддерживается.</b> Если вы хотите запускать свое
+приложение на 1.8.6, откатитесь до Sinatra 1.2, которая будет получать все
+исправления ошибок до тех пор, пока не будет выпущена Sinatra 1.4.0
 
 Мы также следим за предстоящими к выходу версиями Ruby.
 
@@ -1759,7 +1694,7 @@ Sinatra приложения могут быть запущены напряму
 То, что версия официально не поддерживается, означает, что, если что-то не
 работает на этой версии, а на поддерживаемой работает - это не наша проблема, а их.
 
-Мы также запускаем наши CI-тесты на последней версии Ruby (предстоящий 1.9.3),
+Мы также запускаем наши CI-тесты на последней версии Ruby (предстоящей 1.9.3),
 но мы не можем ничего гарантировать, так как она постоянно развивается.
 Предполагается, что 1.9.3p0 будет поддерживаться.
 
@@ -1768,7 +1703,7 @@ Sinatra должна работать на любой операционной
 == На острие
 
 Если вы хотите использовать самый последний код Sinatra, не бойтесь запускать
-свое приложение вместе из master ветки Sinatra, она весьма стабильна.
+свое приложение вместе с кодом из master ветки Sinatra, она весьма стабильна.
 
 Мы также время от времени выпускаем предварительные версии, так что вы можете делать так:
 
@@ -1825,7 +1760,7 @@ Sinatra должна работать на любой операционной
   rake sinatra.gemspec
   rake install
 
-Если вы устанавливаете пакеты (gem) от пользователя root, то вашим последним шагом должна быть команда
+Если вы устанавливаете пакеты (gem) от пользователя root, то вашим следующим шагом должна быть команда
 
   sudo rake install
 
@@ -1842,4 +1777,9 @@ SemVerTag.
 * {Слежение за проблемами/ошибками}[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
+* {IRC: #sinatra}[irc://chat.freenode.net/#sinatra] на http://freenode.net
+* {Sinatra Book}[http://sinatra-book.gittr.com] учебник и сборник рецептов
+* {Sinatra Book Contrib}[http://sinatra-book-contrib.com/] сборник рецептов
+* API документация к {последнему релизу}[http://rubydoc.info/gems/sinatra]
+  или {текущему HEAD}[http://rubydoc.info/github/sinatra/sinatra] на
+  http://rubydoc.info