sinatra 1.2.9 → 1.3.0.a

data/README.ru.rdoc

@@ -18,6 +18,9 @@ Sinatra — это предметно-ориентированный язык (D
 
 Результат будет тут: http://localhost:4567
 
+Рекомендуется также запустить <tt>gem install thin</tt>, чтобы Sinatra
+могла использовать thin в качестве сервера.
+
 == Маршруты
 
 В Sinatra маршрут — это пара: HTTP метод и шаблон (образец) URL.
@@ -32,7 +35,11 @@ Sinatra — это предметно-ориентированный язык (D
   end
 
   put '/' do
-    .. что-то обновить ..
+    .. что-то заменить ..
+  end
+
+  patch '/' do
+    .. что-то изменить ..
   end
 
   delete '/' do
@@ -61,7 +68,7 @@ Sinatra — это предметно-ориентированный язык (D
   end
 
 Шаблоны маршрутов также могут включать splat (wildcard, *, любая строка символов) параметры доступные
-в <tt>params[:splat]</tt> массиве.
+в <tt>params[:splat]</tt> массиве:
 
   get '/say/*/to/*' do
     # соответствует /say/hello/to/world
@@ -147,6 +154,47 @@ Sinatra — это предметно-ориентированный язык (D
 
     get('/') { Stream.new }
 
+=== Собственные детекторы совпадений для маршрутов
+
+Как показано выше, Sinatra поставляется со встроенной поддержкой строк и
+регулярных выражений как шаблонов URL. Но и это еще не все. Вы можете
+легко определить свои собственные детекторы совпадений (matchers) для маршрутов:
+
+  class AllButPattern
+    Match = Struct.new(:captures)
+
+    def initialize(except)
+      @except   = except
+      @captures = Match.new([])
+    end
+
+    def match(str)
+      @captures unless @except === str
+    end
+  end
+
+  def all_but(pattern)
+    AllButPattern.new(pattern)
+  end
+
+  get all_but("/index") do
+    # ...
+  end
+
+Заметьте, что предыдущий пример довольно переусложнен, ведь он также может
+быть записан в следующем виде:
+
+  get // do
+    pass if request.path_info == "/index"
+    # ...
+  end
+
+Или с использованием негативного просмотра вперед:
+
+  get %r{^(?!/index$)} do
+    # ...
+  end
+
 == Статические файлы
 
 Статические файлы отдаются из <tt>./public</tt> директории. Вы можете указать другое место,
@@ -362,7 +410,7 @@ Sinatra — это предметно-ориентированный язык (D
 
 Вы не можете вызывать Ruby из Markdown, соответственно, вы не можете использовать
 лэйаут-шаблоны (layouts) на Markdown. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута с помощью опции `:layout_engine`:
+движок рендеринга для шаблона, а другой для лэйаута с помощью опции <tt>:layout_engine</tt>:
 
   get '/' do
     markdown :index, :layout_engine => :erb
@@ -421,7 +469,7 @@ Sinatra — это предметно-ориентированный язык (D
 
 Вы не можете вызывать Ruby из Textile, соответственно, вы не можете использовать
 лэйаут-шаблоны на Textile. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута с помощью опции `:layout_engine`:
+движок рендеринга для шаблона, а другой для лэйаута с помощью опции <tt>:layout_engine</tt>:
 
   get '/' do
     textile :index, :layout_engine => :erb
@@ -466,7 +514,7 @@ Sinatra — это предметно-ориентированный язык (D
 
 Вы не можете вызывать Ruby из RDoc, соответственно, вы не можете использовать
 лэйаут-шаблоны на RDoc. Тем не менее, есть возможность использовать один
-движок рендеринга для шаблона, а другой для лэйаута с помощью опции `:layout_engine`:
+движок рендеринга для шаблона, а другой для лэйаута с помощью опции <tt>:layout_engine</tt>:
 
   get '/' do
     rdoc :index, :layout_engine => :erb
@@ -604,7 +652,7 @@ Sinatra — это предметно-ориентированный язык (D
   @@ index
   %div.title Hello world!!!!!
 
-Заметьте: Вложенные шаблоны, определенные в файле-исходнике, который подключил Sinatra, будут
+Заметьте: вложенные шаблоны, определенные в файле-исходнике, который подключил Sinatra, будут
 автоматически загружены. Вызовите <tt>enable :inline_templates</tt> напрямую, если у вас вложенные
 шаблоны в других файлах.
 
@@ -626,7 +674,7 @@ Sinatra — это предметно-ориентированный язык (D
 
 Если шаблон с именем "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?
@@ -657,24 +705,9 @@ Sinatra — это предметно-ориентированный язык (D
 Отрисует <tt>./views/index.myat</tt>. Чтобы узнать больше о Tilt,
 смотрите https://github.com/rtomayko/tilt
 
-== Методы-помощники
-
-Используйте метод <tt>helpers</tt>, чтобы определить методы-помощники, которые
-в дальнейшем можно будет использовать в обработчиках маршрутов и шаблонах:
-
-  helpers do
-    def bar(name)
-      "#{name}bar"
-    end
-  end
-
-  get '/:name' do
-    bar(params[:name])
-  end
-
 == Фильтры
 
-Before-фильтры выполняются перед каждым запросом в том же контексте, что и маршруты. Фильтры могут изменять
++before+-фильтры выполняются перед каждым запросом в том же контексте, что и маршруты. Фильтры могут изменять
 как запрос, так и ответ на него. Переменные экземпляра, установленные в фильтрах, доступны в маршрутах и шаблонах:
 
   before do
@@ -687,13 +720,17 @@ Before-фильтры выполняются перед каждым запро
     params[:splat] #=> 'bar/baz'
   end
 
-After-фильтры выполняются после каждого запроса в том же контексте, что и пути. Фильтры могут изменять
-как запрос, так и ответ на него. Переменные экземпляра, установленные в before-фильтрах и маршрутах, будут доступны в after-фильтрах:
++after+-фильтры выполняются после каждого запроса в том же контексте, что и пути. Фильтры могут изменять
+как запрос, так и ответ на него. Переменные экземпляра, установленные в +before+-фильтрах и маршрутах,
+будут доступны в +after+-фильтрах:
 
   after do
     puts response.status
   end
 
+Заметьте: если вы используете метод +body+, а не просто возвращаете строку из
+маршрута, то тело ответа не будет доступно в +after+-фильтрах, потому что оно будет сгенерировано позднее.
+
 Фильтры могут использовать шаблоны URL и будут интерпретированы, только если путь запроса совпадет с этим шаблоном:
 
   before '/protected/*' do
@@ -714,7 +751,67 @@ After-фильтры выполняются после каждого запро
     # ...
   end
 
-== Прерывание
+== Методы-помощники
+
+Используйте метод <tt>helpers</tt>, чтобы определить методы-помощники, которые
+в дальнейшем можно будет использовать в обработчиках маршрутов и шаблонах:
+
+  helpers do
+    def bar(name)
+      "#{name}bar"
+    end
+  end
+
+  get '/:name' do
+    bar(params[:name])
+  end
+
+=== Использование сессий
+
+Сессия используется, чтобы сохранять состояние между запросами. Если эта опция
+включена, то у вас будет один хэш сессии на одну пользовательскую сессию:
+
+  enable :sessions
+
+  get '/' do
+    "value = " << session[:value].inspect
+  end
+
+  get '/:value' do
+    session[:value] = params[:value]
+  end
+
+Заметьте, что при использовании <tt>enable :sessions</tt> все данные
+сохраняются в куки. Это может быть не совсем то, что вы хотите (например,
+сохранение больших объемов данных увеличит ваш трафик). В таком случае вы
+можете использовать альтернативную Rack "прослойку" (middleware), реализующую
+механизм сессий. Для этого *не надо* вызывать <tt>enable :sessions</tt>,
+вместо этого следует подключить ее также как и любую другую "прослойку":
+
+  use Rack::Session::Pool, :expire_after => 2592000
+
+  get '/' do
+    "value = " << session[:value].inspect
+  end
+
+  get '/:value' do
+    session[:value] = params[:value]
+  end
+
+Для повышения безопасности данные сессии в куках подписываются секретным
+ключом. Секретный ключ генерируется Sinatra. Тем не менее, так как этот
+ключ будет меняться с каждым запуском приложения, вы, возможно, захотите
+установить ключ вручную, чтобы у всех экземпляров вашего приложения
+быд один и тот же ключ:
+
+  set :session_secret, 'super secret'
+
+Если вы хотите больше настроек для сессий, вы можете задать их, используя
+хэш с опциями и параметр +sessions+:
+
+  set :sessions, :domain => 'foo.com'
+
+=== Прерывание
 
 Чтобы незамедлительно прервать обработку запроса внутри фильтра или маршрута, используйте:
 
@@ -736,7 +833,11 @@ After-фильтры выполняются после каждого запро
 
   halt 402, {'Content-Type' => 'text/plain'}, 'revenge'
 
-== Передача
+И, конечно, можно использовать шаблоны с +halt+:
+
+  halt erb(:error)
+
+=== Передача
 
 Маршрут может передать обработку запроса следующему совпадающему маршруту, используя <tt>pass</tt>:
 
@@ -752,10 +853,224 @@ After-фильтры выполняются после каждого запро
 Блок маршрута сразу же прерывается, и контроль переходит к следующему совпадающему маршруту.
 Если соответствующий маршрут не найден, то ответом на запрос будет 404.
 
-== Доспут к объекту запроса
+=== Вызов другого маршрута
+
+Иногда +pass+ не подходит, например, если вы хотите получить результат
+вызова другого обработчика маршрута. В таком случае просто используйте +call+:
+
+  get '/foo' do
+    status, headers, body = call request.env.merge("PATH_INFO" => '/bar')
+    [status, body.upcase]
+  end
+
+  get '/bar' do
+    "bar"
+  end
+
+Заметьте, что в предыдущем примере можно облегчить тестирование и повысить
+производительность, перенеся <tt>"bar"</tt> в метод-помощник, используемый
+и в <tt>/foo</tt>, и в <tt>/bar</tt>.
+
+Если вы хотите, чтобы запрос был отправлен в тот же экземпляр приложения, а не
+в его копию, используйте <tt>call!</tt> вместо <tt>call</tt>.
+
+Если хотите узнать больше о <tt>call</tt>, смотрите спецификацию Rack.
+
+=== Задание тела, кода и заголовков ответа
+
+Хорошим тоном является установка кода состояния HTTP и тела ответа в возвращаемом
+значении обработчика маршрута. Тем не менее, в некоторых ситуациях вам, возможно,
+понадобится задать тело ответа в произвольной точке потока исполнения. Вы можете
+сделать это с помощью метода-помощника +body+. Если вы задействуете метод +body+,
+то вы можете использовать его и в дальнейшем, чтобы получить доступ к телу ответа.
+
+  get '/foo' do
+    body "bar"
+  end
+
+  after do
+    puts body
+  end
+
+Также можно передать блок в метод +body+, который затем будет вызван
+обработчиком Rack (такой подход может быть использован для реализации поточного
+ответа, см. "Возвращаемые значения").
+
+Аналогично вы можете установить код ответа и его заголовки:
+
+  get '/foo' do
+    status 418
+    headers \
+      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN"
+      "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
+    body "I'm a tea pot!"
+  end
+
+Как и +body+, методы +headers+ и +status+, вызванные без аргументов, возвращают
+свои текущие значения.
+
+=== Mime-типы
+
+Когда вы используете <tt>send_file</tt> или статические файлы, у вас могут быть mime-типы, которые Sinatra
+не понимает по умолчанию. Используйте +mime_type+ для их регистрации по расширению файла:
+
+  mime_type :foo, 'text/foo'
+
+Вы также можете использовать это в +content_type+ помощнике:
+
+  get '/' do
+    content_type :foo
+    "foo foo foo"
+  end
+
+=== Генерирование URL
+
+Чтобы сформировать URL вам следует использовать метод +url+, например, в Haml:
+
+  %a{:href => url('/foo')} foo
+
+Этот метод учитывает обратные прокси и маршрутизаторы Rack, если они присутствуют.
+
+Наряду с +url+ вы можете использовать +to+ (смотрите пример ниже).
+
+=== Перенаправление (редирект)
+
+Вы можете перенаправить браузер пользователя с помощью метода +redirect+:
+
+  get '/foo' do
+    redirect to('/bar')
+  end
+
+Любые дополнительные параметры используются по аналогии с аргументами метода +halt+:
+
+  redirect to('/bar'), 303
+  redirect 'http://google.com', 'wrong place, buddy'
+
+Вы также можете перенаправить пользователя обратно, на страницу с которой он пришел,
+с помощью <tt>redirect back</tt>:
+
+  get '/foo' do
+    "<a href='/bar'>do something</a>"
+  end
+
+  get '/bar' do
+    do_something
+    redirect back
+  end
+
+Чтобы передать какие-либо параметры вместе с перенаправлением, либо добавьте их в строку запроса:
+
+  redirect to('/bar?sum=42')
+
+Либо используйте сессию:
+
+  enable :session
+
+  get '/foo' do
+    session[:secret] = 'foo'
+    redirect to('/bar')
+  end
+
+  get '/bar' do
+    session[:secret]
+  end
+
+=== Управление кэшированием
+
+Установка корректных заголовков — основа правильного HTTP кэширования.
+
+Вы можете легко выставить заголовок Cache-Control таким образом:
+
+  get '/' do
+    cache_control :public
+    "cache it!"
+  end
+
+Совет: задавайте кэширование в +before+-фильтре:
+
+  before do
+    cache_control :public, :must_revalidate, :max_age => 60
+  end
+
+Если вы используете метод +expires+ для задания соответствующего заголовка,
+то <tt>Cache-Control</tt> будет выставлен автоматически:
+
+  before do
+    expires 500, :public, :must_revalidate
+  end
+
+Чтобы как следует использовать кэши, вам следует подумать об использовании
++etag+ и +last_modified+. Рекомендуется использовать эти методы *до*
+выполнения "тяжелых" вычислений, так как они немедленно отправят ответ клиенту,
+если текущая версия уже есть в его кэше:
+
+  get '/article/:id' do
+    @article = Article.find params[:id]
+    last_modified @article.updated_at
+    etag @article.sha1
+    erb :article
+  end
+
+Так же вы можете использовать
+{weak ETag}[http://en.wikipedia.org/wiki/HTTP_ETag#Strong_and_weak_validation]:
+
+  etag @article.sha1, :weak
+
+Эти методы-помощники не станут ничего кэшировать для вас, но они дадут
+необходимую информацию для вашего кэша. Если вы ищите легкое решение для
+кэширования, попробуйте {rack-cache}[http://rtomayko.github.com/rack-cache/]:
+
+  require "rack/cache"
+  require "sinatra"
+
+  use Rack::Cache
+
+  get '/' do
+    cache_control :public, :max_age => 36000
+    sleep 5
+    "hello"
+  end
+
+=== Отправка файлов
+
+Для отправки файлов пользователю вы можете использовать метод <tt>send_file</tt>:
+
+  get '/' do
+    send_file 'foo.png'
+  end
+
+Этот метод имеет несколько опций:
+
+  send_file 'foo.png', :type => :jpg
+
+Возможные опции:
+
+[filename]
+  имя файла, по умолчанию: реальное имя файла.
+
+[last_modified]
+  значение для заголовка Last-Modified, по умолчанию: mtime (время изменения) файла.
+
+[type]
+  тип файла, по умолчанию: угадывается по расширению файла.
+
+[disposition]
+  используется для заголовка Content-Disposition, возможные значения:
+  +nil+ (по умолчанию), <tt>:attachment</tt> и <tt>:inline</tt>.
+
+[length]
+  значения для заголовка Content-Length, по умолчанию: размер файла.
+
+
+Этот метод будет использовать возможности Rack сервера для отправки файлов, если они
+доступны, а в противном случае, будет напрямую отдавать файл из Ruby процесса.
+Метод <tt>send_file</tt> также обеспечивает автоматическую обработку частичных (range)
+запросов с помощью Sinatra.
 
-Объект входящего запроса доступен на уровне обработки запроса (в фильтрах, маршрутах, обработчиках ошибок)
-с помощью `request` метода:
+=== Доспут к объекту запроса
+
+Объект входящего запроса доступен на уровне обработки запроса (в фильтрах, маршрутах,
+обработчиках ошибок) с помощью <tt>request</tt> метода:
 
   # приложение запущено на http://example.com/example
   get '/foo' do
@@ -772,14 +1087,15 @@ After-фильтры выполняются после каждого запро
     request.get?              # true (есть аналоги для других методов HTTP)
     request.form_data?        # false
     request["SOME_HEADER"]    # значение заголовка SOME_HEADER
-    request.referer           # источник запроса клиента либо '/'
+    request.referrer          # источник запроса клиента либо '/'
     request.user_agent        # user agent (используется для :agent условия)
     request.cookies           # хеш с куками браузера
     request.xhr?              # является ли запрос ajax запросом?
     request.url               # "http://example.com/example/foo"
     request.path              # "/example/foo"
     request.ip                # IP-адрес клиента
-    request.secure?           # false
+    request.secure?           # false (true, если запрос сделан через SSL)
+    request.forwarded?        # true (если сервер работает за обратным прокси)
     request.env               # "сырой" env хеш, полученный Rack
   end
 
@@ -799,16 +1115,86 @@ After-фильтры выполняются после каждого запро
     "Hello #{data['name']}!"
   end
 
+=== Вложения
+
+Вы можете использовать метод +attachment+, чтобы сказать браузеру, что ответ
+сервера должен быть сохранен на диск, а не отображен:
+
+  get '/' do
+    attachment
+    "store it!"
+  end
+
+Вы также можете указать и имя файла:
+
+  get '/' do
+    attachment "info.txt"
+    "store it!"
+  end
+
+=== Поиск шаблонов
+
+Для поиска шаблонов и их последующего рендеринга используется метод <tt>find_template</tt>:
+
+  find_template settings.views, 'foo', Tilt[:haml] do |file|
+    puts "could be #{file}"
+  end
+
+Это не очень-то полезный пример. Зато полезен тот факт, что вы можете переопределить
+этот метод, чтобы использовать свой собственный механизм поиска. Например, если вы
+хотите, чтобы можно было использовать несколько директорий с шаблонами:
+
+  set :views, ['views', 'templates']
+
+  helpers do
+    def find_template(views, name, engine, &block)
+      Array(views).each { |v| super(v, name, engine, &block) }
+    end
+  end
+
+Другой пример, в котором используются разные директории для движков рендеринга:
+
+  set :views, :sass => 'views/sass', :haml => 'templates', :default => 'views'
+
+  helpers do
+    def find_template(views, name, engine, &block)
+      _, folder = views.detect { |k,v| engine == Tilt[k] }
+      folder ||= views[:default]
+      super(folder, name, engine, &block)
+    end
+  end
+
+Вы можете легко вынести этот код в расширение и поделиться им с остальными!
+
+Заметьте, что <tt>find_template</tt не проверяет, существует ли файл на самом деле,
+а вызывает заданный блок для всех возможных путей. Дело тут не в производительности,
+дело в том, что +render+ вызовет +break+, как только файл не будет найден.
+Содержимое и местонахождение шаблонов будет закэшировано, если приложение запущено не
+в режиме разработки. Вы должны помнить об этих нюансах, если пишите по-настоящему
+сумашедший метод.
+
 == Конфигурация
 
 Этот блок исполняется один раз при старте в любом окружении, режиме (environment):
 
   configure do
-    ...
+    # задание одной опции
+    set :option, 'value'
+
+    # устанавливаем несколько опций
+    set :a => 1, :b => 2
+
+    # то же самое, что и `set :option, true`
+    enable :option
+
+    # то же самое, что и `set :option, false`
+    disable :option
+
+    # у вас могут быть "динамические" опции с блоками
+    set(:css_dir) { File.join(views, 'css') }
   end
 
-Будет запущено, когда окружение (RACK_ENV переменная) установлена в
-<tt>:production</tt>:
+Будет запущено, когда окружение (RACK_ENV переменная) <tt>:production</tt>:
 
   configure :production do
     ...
@@ -820,9 +1206,104 @@ After-фильтры выполняются после каждого запро
     ...
   end
 
+Вы можете получить доступ к этим опциям с помощью <tt>settings</tt>:
+
+  configure do
+    set :foo, 'bar'
+  end
+
+  get '/' do
+    settings.foo? # => true
+    settings.foo  # => 'bar'
+    ...
+  end
+
+=== Доступные настройки
+
+[absolute_redirects]  если отключено, то Sinatra будет позволять использование
+                      относительных перенаправлений, тем не менее, Sinatra перестанет
+                      соответствовать RFC 2616 (HTTP 1.1), который разрешает только
+                      абсолютные перенаправления.
+
+                      Включайте эту опцию, если ваше приложение работает за обратным прокси,
+                      который настроен не совсем корректно. Обратите внимание, метод +url+
+                      все равно будет генерировать абсолютные URL, если вы не передадите
+                      +false+ вторым аргументом.
+
+                      Отключено по умолчанию.
+
+[add_charsets]        mime-типы, к которым метод <tt>content_type</tt> будет автоматически
+                      добавлять информацию о кодировке.
+
+                      Вам следует добавлять значения к этой опции вместо ее переопределения:
+
+                        settings.add_charsets << "application/foobar"
+
+[app_file]            главный файл приложения, используется для определения корневой директории
+                      проекта, директорий с шаблонами и статическими файлами, вложенных шаблонов.
+
+[bind]                используемый IP-адрес (по умолчанию: 0.0.0.0). Используется только
+                      встроенным сервером.
+
+[default_encoding]    кодировка, если неизвестна (по умолчанию: <tt>"utf-8"</tt>).
+
+[dump_errors]         отображать ошибки в логе.
+
+[environment]         текущее окружение, по умолчанию, значение <tt>ENV['RACK_ENV']</tt>
+                      или <tt>"development"</tt>, если <tt>ENV['RACK_ENV']</tt> не доступна.
+
+[logging]             использовать логгер.
+
+[lock]                создает блокировку для каждого запроса, которая гарантирует обработку
+                      только одного запроса в текущий момент времени в Ruby процессе.
+
+                      Включайте, если ваше приложение не потоко-безопасно (thread-safe).
+                      Отключено по умолчанию.
+
+[method_override]     использовать "магический" параметр <tt>_method</tt>, чтобы позволить
+                      использование PUT/DELETE форм в браузерах, которые не поддерживают
+                      эти методы.
+
+[port]                порт, на котором будет работать сервер. Используется только
+                      встроенным сервером.
+
+[prefixed_redirects]  добавлять или нет параметр <tt>request.script_name</tt> к редиректам,
+                      если не задан абсолютный путь. Таким образом  <tt>redirect '/foo'</tt>
+                      будет вести себя как <tt>redirect to('/foo')</tt>. Отключено по умолчанию.
+
+[public]              директория, откуда будут раздаваться статические файлы.
+
+[reload_templates]    перезагружать или нет шаблоны на каждый запрос.
+                      Включено в режиме разработки.
+
+[root]                корневая директория проекта.
+
+[raise_errors]        возбуждать исключения (будет останавливать приложение).
+
+[run]                 если включено, Sinatra будет самостоятельно запускать веб-сервер.
+                      Не включайте, если используете rackup или аналогичные средства.
+
+[running]             работает ли сейчас встроенный сервер?
+                      Не меняйте эту опцию!
+
+[server]              сервер или список серверов, которые следует использовать в качестве
+                      встроенного сервера. По умолчанию: ['thin', 'mongrel', 'webrick'],
+                      порядок задает приоритет.
+
+[sessions]            включить сессии на основе кук (cookie).
+
+[show_exceptions]     показывать стек вызовов (stack trace) в браузере.
+
+[static]              должен ли Sinatra осуществлять раздачу статических файлов.
+                      Отключите, когда используете какой-либо веб-сервер для этой цели.
+                      Отключение значительно улучшит производительность приложения.
+                      Включено по умолчанию.
+
+[views]               директория с шаблонами.
+
 == Обработка ошибок
 
-Обработчики ошибок исполняются в том же контексте, что и маршруты, before-фильтры, а это означает, что всякие
+Обработчики ошибок исполняются в том же контексте, что и маршруты, +before+-фильтры, а это означает, что всякие
 прелести вроде <tt>haml</tt>, <tt>erb</tt>, <tt>halt</tt> и т.д. доступны и им.
 
 === NotFound
@@ -875,20 +1356,9 @@ After-фильтры выполняются после каждого запро
     'Boom'
   end
 
-Sinatra устанавливает специальные <tt>not_found</tt> и <tt>error</tt> обработчики, когда запущена в режиме
+Sinatra устанавливает специальные <tt>not_found</tt> и <tt>error</tt> обработчики, когда запущен в режиме
 разработки (окружение <tt>:development</tt>).
 
-== Mime-типы
-
-Когда вы используете <tt>send_file</tt> или статические файлы, у вас могут быть mime-типы, которые Sinatra
-не понимает по умолчанию. Используйте +mime_type+ для их регистрации по расширению файла:
-
-  mime_type :foo, 'text/foo'
-
-Вы также можете использовать это в +content_type+ помощнике:
-
-  content_type :foo
-
 == Rack "прослойки"
 
 Sinatra использует Rack[http://rack.rubyforge.org/], минимальный стандартный 
@@ -984,14 +1454,42 @@ DSL верхнего уровня загрязняет пространство
 в DSL верхнего уровня. Большинство приложений верхнего уровня могут быть
 конвертированы в Sinatra::Base компоненты с помощью двух модификаций:
 
-* Вы должны подключать +sinatra/base+ вместо +sinatra+,
-  иначе все методы предоставляемые Sinatra будут импортированные в глобальное пространство имен.
+* Вы должны подключать <tt>sinatra/base</tt> вместо +sinatra+,
+  иначе все методы предоставляемые Sinatra будут импортированы в глобальное пространство имен.
 * Поместите все маршруты, обработчики ошибок, фильтры и опции в сабкласс Sinatra::Base.
 
 <tt>Sinatra::Base</tt> — это чистый лист. Большинство опций, включая встроенный сервер, по умолчанию отключены.
 Смотрите {Опции и Конфигурация}[http://www.sinatrarb.com/configuration.html] для детальной информации
 об опциях и их поведении.
 
+=== Модульные приложения против классических
+
+Вопреки всеобщему убеждению в классическом стиле (самом простом) нет ничего плохого.
+Если этот стиль подходит вашему приложению, вы не обязаны переписывать его в модульное
+приложение.
+
+У классического стиля есть всего два недостатка относительно модульного:
+
+* У вас может быть только одно приложение Sinatra на Ruby процесс. Если вы планируете
+  использовать больше, то переключайтесь на модульный стиль.
+
+* Приложения, использующие классический стиль, добавляют методы к Object. Если вы
+  планируете поставлять свое приложение в виде библиотеки/gem, то переключайтесь
+  на модульный стиль.
+
+Не существует причин, по которым вы не могли бы смешивать модульный и классический стили.
+
+Переходя с одного стиля на другой, примите во внимание следующие изменения в настройках:
+
+  Опция               Классический            Модульный
+
+  app_file            файл с приложением      nil
+  run                 $0 == app_file          false
+  logging             true                    false
+  method_override     true                    false
+  inline_templates    true                    false
+
+
 === Запуск модульных приложений
 
 Есть два общепринятых способа запускать модульные приложения: запуск напрямую с помощью <tt>run!</tt>:
@@ -1014,14 +1512,14 @@ DSL верхнего уровня загрязняет пространство
 Rack-совместимый сервер приложений.
 
   # config.ru
-  require './my_app'
+  require 'my_app'
   run MyApp
 
 Запускаем:
 
   rackup -p 4567
 
-=== Запуск "классических" приложений с config.ru
+=== Запуск классических приложений с config.ru
 
 Файл приложения:
 
@@ -1034,7 +1532,7 @@ Rack-совместимый сервер приложений.
 
 И соответствующий <tt>config.ru</tt>:
 
-  require './app'
+  require 'app'
   run Sinatra::Application
 
 === Когда использовать config.ru?
@@ -1052,9 +1550,9 @@ Rack-совместимый сервер приложений.
 
 === Использование Sinatra в качестве "прослойки"
 
-Не только сама Sinatra может использовать "прослойки" Rack, но и любое Sinatra приложение
+Не только сам Sinatra может использовать "прослойки" Rack, но и любое Sinatra приложение
 само может быть добавлено к любому Rack эндпоинту в качестве "прослойки". Этим эндпоинтом
-может быть другое Sinatra приложение, или приложение, основанное на Rack (Rails/Ramaze/Camping/...).
+может быть другое Sinatra приложение, или приложение, основанное на Rack (Rails/Ramaze/Camping/...):
 
   require 'sinatra/base'
   
@@ -1096,11 +1594,11 @@ Rack-совместимый сервер приложений.
 используете DSL верхнего 
 уровня (<tt>require 'sinatra'</tt>), то этим классом будет 
 Sinatra::Application, иначе это будет сабкласс, который вы создали вручную.
-На уровне класса вам будут доступны такие методы, как `get` или `before`, но вы
-не сможете иметь доступ к объектам `request` или `session`, так как существует
-только единый класс приложения для всех запросов.
+На уровне класса вам будут доступны такие методы, как +get+ или +before+, но вы
+не сможете иметь доступ к объектам +request+ или +session+, так как существует
+только один класс приложения для всех запросов.
 
-Опции, созданные с помощью `set`, являются методами уровня класса:
+Опции, созданные с помощью +set+, являются методами уровня класса:
 
     class MyApp < Sinatra::Base
       # Я в области видимости приложения!
@@ -1116,21 +1614,21 @@ Sinatra::Application, иначе это будет сабкласс, котор
 
 * Тела вашего класса приложения
 * Методов, определенных расширениями
-* Блока, переданного в `helpers`
-* Блоков, использованных как значения для `set`
+* Блока, переданного в +helpers+
+* Блоков, использованных как значения для +set+
 
 Вы можете получить доступ к объекту области видимости (классу приложения) следующими способами:
 
 * объект, переданный блокам конфигурации (<tt>configure { |c| ... }</tt>)
-* `settings` внутри области видимости запроса
+* +settings+ внутри области видимости запроса
 
 === Область видимости запроса/экземпляра
 
 Для каждого входящего запроса будет создан новый экземпляр вашего приложения,
 и все блоки обработчика будут запущены в этом контексте. В этой области
-видимости вам доступны `request` и `session` объекты, вызовы методов
-рендеринга, такие как `erb` или `haml`. Вы можете получить доступ к
-области видимости приложения из контекста запроса, используя помощник `settings`:
+видимости вам доступны +request+ и +session+ объекты, вызовы методов
+рендеринга, такие как +erb+ или +haml+. Вы можете получить доступ к
+области видимости приложения из контекста запроса, используя помощник +settings+:
 
   class MyApp < Sinatra::Base
     # Я в области видимости приложения!
@@ -1160,14 +1658,14 @@ Sinatra::Application, иначе это будет сабкласс, котор
 Однако, оно не полностью на 100% ведет себя как область видимости класса,
 так как у вас нету привязки к классу: только методы, явно помеченные для
 делегирования, будут доступны, а переменных/состояний области видимости класса
-не будет (иначе говоря, у вас будет другой `self` объект). Вы можете
+не будет (иначе говоря, у вас будет другой +self+ объект). Вы можете
 непосредственно добавить методы делегирования, используя
 <tt>Sinatra::Delegator.delegate :method_name</tt>.
 
 У вас будет контекст делегирования внутри:
 
 * Привязки верхнего уровня, если вы сделали <tt>require "sinatra"</tt>
-* Объекта, расширенного с помощью примеси `Sinatra::Delegator`
+* Объекта, расширенного с помощью примеси <tt>Sinatra::Delegator</tt>
 
 Посмотрите сами в код: тут
 {Sinatra::Delegator примесь}[http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/base.rb#L1128]
@@ -1188,6 +1686,53 @@ Sinatra приложения могут быть запущены напряму
   -s # настроить rack сервер/обработчик (по умолчанию thin)
   -x # включить мьютекс (по умолчанию выключен)
 
+== Системные требования
+
+Следующие версии Ruby официально поддерживаются:
+
+[ Ruby 1.8.7 ]
+  1.8.7 полностью поддерживается, тем не менее, если вас ничто не держит на
+  этой версии, рекомендуем обновиться до 1.9.2 или перейти на JRuby или Rubinius.
+
+[ Ruby 1.9.2 ]
+  1.9.2 поддерживается и рекомендована. Заметьте, что Radius и Markaby
+  пока несовместимы с 1.9.2. Не используйте 1.9.2p0, известно, что эта
+  версия весьма не стабильна при использовании Sinatra.
+
+[ Rubinius ]
+  Rubinius официально поддерживается (Rubinius >= 1.2.3), все, включая все
+  языки шаблонов, работает.
+
+[ JRuby ]
+  JRuby официально поддерживается (JRuby >= 1.6.0). Нет никаких проблем с
+  использованием альтернативных шаблонов. Тем не менее, если вы выбираете
+  JRuby, то, пожалуйста, посмотрите на JRuby Rack-сервера, так как Thin не
+  поддерживается полностью на JRuby. Поддержка расширений на C в JRuby все
+  еще экспериментальная, что на данный момент затрагивает только RDiscount.
+
+<b>Ruby 1.8.6 больше не поддерживается.</b>
+
+Мы также следим за новыми версиями 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]
+
+То, что версия официально не поддерживается, означает, что, если что-то не
+работает на этой версии, а на поддерживаемой работает, то мы предполагаем,
+что это не наша проблема, а их.
+
+Мы также запускаем наши CI-тесты на последней версии Ruby (предстоящий 1.9.3),
+но мы не можем ничего гарантировать, так как она постоянно развивается.
+Предполагается, что 1.9.3p0 будет поддерживаться.
+
+Sinatra должен работать на любой операционной системе, поддерживаемой выбранной
+реализацией Ruby.
+
 == На острие
 
 Если вы хотите использовать самый последний код Sinatra, не бойтесь запускать
@@ -1228,7 +1773,7 @@ Sinatra приложения могут быть запущены напряму
 === Вручную
 
 Создайте локальный клон репозитория и запускайте свое приложение с <tt>sinatra/lib</tt>
-директорией в <tt>LOAD_PATH</tt>:
+директорией в <tt>$LOAD_PATH</tt>:
 
   cd myapp
   git clone git://github.com/sinatra/sinatra.git
@@ -1252,6 +1797,11 @@ Sinatra приложения могут быть запущены напряму
 
   sudo rake install
 
+== Версии
+
+Sinatra использует {Semantic Versioning}[http://semver.org/], SemVer и
+SemVerTag.
+
 == Дальнейшее чтение
 
 * {Вебсайт проекта}[http://www.sinatrarb.com/] - Дополнительная документация,