Merge branch 'master' of https://github.com/vast/sinatra into vast-master

README.ru.rdoc

@@ -94,7 +94,7 @@ Sinatra — это предметно-ориентированный язык (D
   end
 
   get '/foo' do
-    # соответствует с non-songbird браузерам
+    # соответствует non-songbird браузерам
   end
 
 Другими доступными условиями являются +host_name+ и +provides+:
@@ -126,7 +126,7 @@ Sinatra — это предметно-ориентированный язык (D
 === Возвращаемые значения
 
 Возвращаемое значение блока маршрута ограничивается телом ответа, которое будет передано HTTP клиенту,
-или следующей подпрограммой (middleware) в Rack стеке. Чаще всего это строка, как в вышеизложенных примерах.
+или следующей "прослойкой" (middleware, промежуточная программа) в Rack стеке. Чаще всего это строка, как в вышеизложенных примерах.
 Но и другие значения также приемлемы.
 
 Вы можете вернуть любой объект, который будет либо корректным Rack ответом, Rack
@@ -172,7 +172,7 @@ Sinatra — это предметно-ориентированный язык (D
 
 === Haml шаблоны
 
-Haml gem/библиотека необходима для рендеринга HAML шаблонов:
+<tt>haml</tt> gem/библиотека необходима для рендеринга HAML шаблонов:
 
   # Вам нужно будет подключить haml gem в приложении
   require 'haml'
@@ -204,24 +204,35 @@ Haml gem/библиотека необходима для рендеринга H
     erb :index
   end
 
-Отрисует <tt>./views/index.erb</tt>
+Отрисует <tt>./views/index.erb</tt>.
 
 === Erubis шаблоны
 
-Erubis gem/библиотека необходима для рендеринга erubis шаблонов:
+<tt>erubis</tt> gem/библиотека необходима для рендеринга Erubis шаблонов:
 
-  # Вам нужно будет подключить erubis в приложении
+  # Вам нужно будет подключить Erubis в приложении
   require 'erubis'
 
   get '/' do
     erubis :index
   end
 
-Отрисует <tt>./views/index.erubis</tt>
+Отрисует <tt>./views/index.erubis</tt>.
+
+Также возможно заменить Erb на Erubis:
+
+  require 'erubis'
+  Tilt.register :erb, Tilt[:erubis]
+
+  get '/' do
+    erb :index
+  end
+
+Отрисует <tt>./views/index.erb</tt> с помощью Erubis.
 
 === Builder шаблоны
 
-Builder gem/библиотека необходима для рендеринга builder шаблонов:
+<tt>builder</tt> gem/библиотека необходима для рендеринга builder шаблонов:
 
   # Вам нужно будет подключить builder в приложении
   require 'builder'
@@ -234,7 +245,7 @@ Builder gem/библиотека необходима для рендеринг
 
 === Nokogiri шаблоны
 
-Nokogiri gem/библиотека необходима для рендеринга nokogiri шаблонов:
+<tt>nokogiri</tt> gem/библиотека необходима для рендеринга nokogiri шаблонов:
 
   # Вам нужно будет подключить nokogiri в приложении
   require 'nokogiri'
@@ -247,7 +258,7 @@ Nokogiri gem/библиотека необходима для рендеринг
 
 === Sass шаблоны
 
-Haml gem/библиотека необходима для рендеринга Sass шаблонов:
+<tt>haml</tt> gem/библиотека необходима для рендеринга Sass шаблонов:
 
   # Вам нужно будет подключить haml или sass в приложении
   require 'sass'
@@ -271,7 +282,7 @@ Haml gem/библиотека необходима для рендеринга S
 
 === Scss шаблоны
 
-Haml gem/библиотека необходима для рендеринга Scss шаблонов:
+<tt>haml</tt> gem/библиотека необходима для рендеринга Scss шаблонов:
 
   # Вам нужно будет подключить haml или sass в приложении
   require 'sass'
@@ -295,7 +306,7 @@ Haml gem/библиотека необходима для рендеринга S
 
 === Less шаблоны
 
-less gem/библиотека необходима для рендеринга Less шаблонов:
+<tt>less</tt> gem/библиотека необходима для рендеринга Less шаблонов:
 
   # Вам нужно будет подключить less в приложении
   require 'less'
@@ -308,7 +319,7 @@ less gem/библиотека необходима для рендеринга L
 
 === Liquid шаблоны
 
-liquid gem/библиотека необходима для рендеринга liquid шаблонов:
+<tt>liquid</tt> gem/библиотека необходима для рендеринга liquid шаблонов:
 
   # Вам нужно будет подключить liquid в приложении
   require 'liquid'
@@ -326,7 +337,7 @@ liquid gem/библиотека необходима для рендеринга
 
 === Markdown шаблоны
 
-rdiscount gem/библиотека необходима для рендеринга Markdown шаблонов:
+<tt>rdiscount</tt> gem/библиотека необходима для рендеринга Markdown шаблонов:
 
   # Вам нужно будет подключить rdiscount в приложении
   require "rdiscount"
@@ -338,19 +349,56 @@ rdiscount gem/библиотека необходима для рендерин
 Отрисует <tt>./views/index.markdown</tt> (+md+ и +mkd+ также являются допустимыми файловыми
 расширениями).
 
-В markdown невозможно вызывать методы или передавать локальные переменные. Следовательно, вам скорее всего придется 
+В Markdown невозможно вызывать методы или передавать локальные переменные.
-использовать этот шаблон совместно с другим движком рендеринга:
+Следовательно, вам, скорее всего, придется использовать этот шаблон совместно с другим
+движком рендеринга:
 
   erb :overview, :locals => { :text => markdown(:introduction) }
 
-Заметьте, что вы можете вызывать метод markdown из других шаблонов:
+Заметьте, что вы можете вызывать метод +markdown+ из других шаблонов:
 
   %h1 Hello From Haml!
   %p= markdown(:greetings)
 
+Вы не можете вызывать Ruby из Markdown, соответственно, вы не можете использовать
+лэйаут-шаблоны (layouts) на Markdown. Тем не менее, есть возможность использовать один
+движок рендеринга для шаблона, а другой для лэйаута с помощью опции `:layout_engine`:
+
+  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.
+
 === Textile шаблоны
 
-RedCloth gem/библиотека необходима для рендеринга Textile шаблонов:
+<tt>RedCloth</tt> gem/библиотека необходима для рендеринга Textile шаблонов:
 
   # Вам нужно будет подключить redcloth в приложении
   require "redcloth"
@@ -361,19 +409,41 @@ RedCloth gem/библиотека необходима для рендеринг
 
 Отрисует <tt>./views/index.textile</tt>.
 
-В textile невозможно вызывать методы или передавать локальные переменные. Следовательно, вам скорее всего придется 
+В Textile невозможно вызывать методы или передавать локальные переменные. Следовательно, вам, скорее всего,
-использовать этот шаблон совместно с другим движком рендеринга:
+придется использовать этот шаблон совместно с другим движком рендеринга:
 
   erb :overview, :locals => { :text => textile(:introduction) }
 
-Заметьте, что вы можете вызывать метод textile из других шаблонов:
+Заметьте, что вы можете вызывать метод +textile+ из других шаблонов:
 
   %h1 Hello From Haml!
   %p= textile(:greetings)
 
+Вы не можете вызывать Ruby из Textile, соответственно, вы не можете использовать
+лэйаут-шаблоны на Textile. Тем не менее, есть возможность использовать один
+движок рендеринга для шаблона, а другой для лэйаута с помощью опции `:layout_engine`:
+
+  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> в качестве лэйаута.
+
 === RDoc шаблоны
 
-RDoc gem/библиотека необходима для рендеринга RDoc шаблонов:
+<tt>rdoc</tt> gem/библиотека необходима для рендеринга RDoc шаблонов:
 
   # Вам нужно будет подключить rdoc в приложении
   require "rdoc"
@@ -384,19 +454,41 @@ RDoc gem/библиотека необходима для рендеринга R
 
 Отрисует <tt>./views/index.rdoc</tt>.
 
-В rdoc невозможно вызывать методы или передавать локальные переменные. Следовательно, вам скорее всего придется 
+В RDoc невозможно вызывать методы или передавать локальные переменные. Следовательно, вам, скорее всего,
-использовать этот шаблон совместно с другим движком рендеринга:
+придется использовать этот шаблон совместно с другим движком рендеринга:
 
   erb :overview, :locals => { :text => rdoc(:introduction) }
 
-Заметьте, что вы можете вызывать метод rdoc из других шаблонов:
+Заметьте, что вы можете вызывать метод +rdoc+ из других шаблонов:
 
   %h1 Hello From Haml!
   %p= rdoc(:greetings)
 
+Вы не можете вызывать Ruby из RDoc, соответственно, вы не можете использовать
+лэйаут-шаблоны на RDoc. Тем не менее, есть возможность использовать один
+движок рендеринга для шаблона, а другой для лэйаута с помощью опции `:layout_engine`:
+
+  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> в качестве лэйаута.
+
 === Radius шаблоны
 
-radius gem/библиотека необходима для рендеринга Radius шаблонов:
+<tt>radius</tt> gem/библиотека необходима для рендеринга Radius шаблонов:
 
   # Вам нужно будет подключить radius в приложении
   require 'radius'
@@ -414,7 +506,7 @@ radius gem/библиотека необходима для рендеринга
 
 === Markaby шаблоны
 
-markaby gem/библиотека необходима для рендеринга Markaby шаблонов:
+<tt>markaby</tt> gem/библиотека необходима для рендеринга Markaby шаблонов:
 
   # Вам нужно будет подключить markaby в приложении
   require 'markaby'
@@ -425,8 +517,7 @@ markaby gem/библиотека необходима для рендеринг
 
 Отрисует <tt>./views/index.mab</tt>.
 
-Если у вас установлен Tilt версии 1.2 или выше, то вы также можете использовать внутристроковые
+Вы также можете использовать внутристроковые Markaby шаблоны:
-markaby шаблоны:
 
   get '/' do
     markaby { h1 "Welcome!" }
@@ -434,7 +525,7 @@ markaby шаблоны:
 
 === Slim шаблоны
 
-slim gem/библиотека необходима для рендеринга slim шаблонов:
+<tt>slim</tt> gem/библиотека необходима для рендеринга slim шаблонов:
 
   # Вам нужно будет подключить slim в приложении
   require 'slim'
@@ -447,7 +538,16 @@ slim gem/библиотека необходима для рендеринга s
 
 === CoffeeScript шаблоны
 
-coffee-script gem/библиотека и `coffee` бинарный файл необходимы для рендеринга CoffeeScript шаблонов:
+Вам понадобится <tt>coffee-script</tt> gem/библиотека и что-то <b>одно</b> из следующего списка,
+чтобы запускать JavaScript:
+
+* +node+ (из Node.js)
+* вы можете использовать OSX (есть встроенные средства для выполнения JavaScript)
+* +therubyracer+ gem/библиотека
+
+Подробнее смотрите на {странице проекта}[http://github.com/josh/ruby-coffee-script].
+
+Таким образом вы можете использовать CoffeeScript шаблоны.
 
   # Вам нужно будет подключить coffee-script в приложении
   require 'coffee-script'
@@ -458,18 +558,18 @@ coffee-script gem/библиотека и `coffee` бинарный файл н
 
 Отрисует <tt>./views/application.coffee</tt>.
 
-=== Внутристроковые шаблоны
+=== Встроенные шаблоны
 
   get '/' do
     haml '%div.title Hello World'
   end
 
-Отрисует внутристроковый шаблон.
+Отрисует встроенный (строчный) шаблон.
 
 === Доступ к переменным в шаблонах
 
-Шаблоны интерпретируются в том же контексте, что и обработчики маршрутов. Переменные экзмепляра, 
+Шаблоны интерпретируются в том же контексте, что и обработчики маршрутов. Переменные экземпляра,
-установленные в процесе обработки маршрутов, будут доступны напрямую в шаблонах:
+установленные в процессе обработки маршрутов, будут доступны напрямую в шаблонах:
 
   get '/:id' do
     @foo = Foo.find(params[:id])
@@ -483,7 +583,7 @@ coffee-script gem/библиотека и `coffee` бинарный файл н
     haml '%h1= foo.name', :locals => { :foo => foo }
   end
 
-Это обычно используется когда шаблоны рендерятся как частные (partials) из других шаблонов.
+Это обычный подход, когда шаблоны рендерятся как частные (partials) из других шаблонов.
 
 === Вложенные шаблоны
 
@@ -504,7 +604,7 @@ coffee-script gem/библиотека и `coffee` бинарный файл н
   @@ index
   %div.title Hello world!!!!!
 
-Заметьте: Вложенные шаблоны, определенные в файле-исходнике, который подключил sinatra, будут
+Заметьте: Вложенные шаблоны, определенные в файле-исходнике, который подключил Sinatra, будут
 автоматически загружены. Вызовите <tt>enable :inline_templates</tt> напрямую, если у вас вложенные
 шаблоны в других файлах.
 
@@ -525,16 +625,42 @@ coffee-script gem/библиотека и `coffee` бинарный файл н
   end
 
 Если шаблон с именем "layout" существует, то он будет использован каждый раз,
-когда шаблоны будут отрисовываться. Вы можете отключить layout-шаблон с помощью <tt>:layout => false</tt>.
+когда шаблоны будут отрисовываться. Вы можете отключать лэйаут в каждом конкретном случае с помощью
+<tt>:layout => false</tt> или отключить его для всего приложения, например, так: <tt>set :haml, :layout => false</tt>.
 
   get '/' do
     haml :index, :layout => !request.xhr?
   end
 
-== Методы помощники
+=== Привязка файловых расширений
 
-Используйте <tt>helpers</tt> метод для определения методов помощников для дальнейшего 
+Чтобы связать расширение файла и движок рендеринга, используйте
-использования в обработчиках маршрутов и шаблонах:
+<tt>Tilt.register</tt>. Например, если вы хотите использовать расширение +tt+
+для шаблонов Textile:
+
+  Tilt.register :tt, Tilt[:textile]
+
+=== Добавление собственного движка рендеринга
+
+Сначала зарегистрируйте свой движок в Tilt, затем создайте метод, отвечающий за отрисовку:
+
+  Tilt.register :myat, MyAwesomeTemplateEngine
+
+  helpers do
+    def myat(*args) render(:myat, *args) end
+  end
+
+  get '/' do
+    myat :index
+  end
+
+Отрисует <tt>./views/index.myat</tt>. Чтобы узнать больше о Tilt,
+смотрите https://github.com/rtomayko/tilt
+
+== Методы-помощники
+
+Используйте метод <tt>helpers</tt>, чтобы определить методы-помощники, которые
+в дальнейшем можно будет использовать в обработчиках маршрутов и шаблонах:
 
   helpers do
     def bar(name)
@@ -641,23 +767,23 @@ After-фильтры выполняются после каждого запро
     request.request_method    # "GET"
     request.query_string      # ""
     request.content_length    # длина тела запроса
-    request.media_type        # медиа тип тела запроса
+    request.media_type        # медиатип тела запроса
     request.host              # "example.com"
-    request.get?              # true (для других участвующих HTTP глаголов есть похожие методы)
+    request.get?              # true (есть аналоги для других методов HTTP)
     request.form_data?        # false
-    request["SOME_HEADER"]    # значение SOME_HEADER заголовка
+    request["SOME_HEADER"]    # значение заголовка SOME_HEADER
     request.referer           # источник запроса клиента либо '/'
     request.user_agent        # user agent (используется для :agent условия)
-    request.cookies           # хеш куки браузера
+    request.cookies           # хеш с куками браузера
     request.xhr?              # является ли запрос ajax запросом?
     request.url               # "http://example.com/example/foo"
     request.path              # "/example/foo"
-    request.ip                # IP адрес клиента
+    request.ip                # IP-адрес клиента
     request.secure?           # false
-    request.env               # env хеш как получено Rack
+    request.env               # "сырой" env хеш, полученный Rack
   end
 
-Некоторые опции, такие как <tt>script_name</tt> или <tt>path_info</tt> могут быть переписаны:
+Некоторые опции, такие как <tt>script_name</tt> или <tt>path_info</tt> доступны для записи:
 
   before { request.path_info = "/" }
   
@@ -699,7 +825,7 @@ After-фильтры выполняются после каждого запро
 Обработчики ошибок исполняются в том же контексте, что и маршруты, before-фильтры, а это означает, что всякие
 прелести вроде <tt>haml</tt>, <tt>erb</tt>, <tt>halt</tt> и т.д. доступны и им.
 
-===  NotFound
+=== NotFound
 
 Когда возбуждено исключение <tt>Sinatra::NotFound</tt>, или кодом ответа является 404,
 то будет вызван <tt>not_found</tt> обработчик:
@@ -752,9 +878,9 @@ After-фильтры выполняются после каждого запро
 Sinatra устанавливает специальные <tt>not_found</tt> и <tt>error</tt> обработчики, когда запущена в режиме
 разработки (окружение <tt>:development</tt>).
 
-== Mime типы
+== Mime-типы
 
-Когда вы используете <tt>send_file</tt> или статические файлы, у вас могут быть mime типы, которые Sinatra
+Когда вы используете <tt>send_file</tt> или статические файлы, у вас могут быть mime-типы, которые Sinatra
 не понимает по умолчанию. Используйте +mime_type+ для их регистрации по расширению файла:
 
   mime_type :foo, 'text/foo'
@@ -763,15 +889,15 @@ Sinatra устанавливает специальные <tt>not_found</tt> и
 
   content_type :foo
 
-== Rack подпрограммы
+== Rack "прослойки"
 
 Sinatra использует Rack[http://rack.rubyforge.org/], минимальный стандартный 
 интерфейс для веб-фреймворков на Ruby. Одной из самых интересных для разработчиков возможностей Rack
-является поддержка подпрограмм ("middleware") -- компонентов,
+является поддержка "прослоек" ("middleware") — компонентов,
 "сидящих" между сервером и вашим приложением, которые отслеживают и/или манипулируют
 HTTP запросами/ответами для предоставления различной функциональности.
 
-В Sinatra очень просто использовать такие Rack подпрограммы с помощью метода +use+:
+В Sinatra очень просто использовать такие "прослойки" с помощью метода +use+:
 
   require 'sinatra'
   require 'my_custom_middleware'
@@ -792,7 +918,7 @@ Rack::Builder[http://rack.rubyforge.org/doc/classes/Rack/Builder.html] DSL
     username == 'admin' && password == 'secret'
   end
 
-Rack распространяется с различными стандартными подпрограммами
+Rack распространяется с различными стандартными "прослойками"
 для логирования, отладки, маршрутизации URL, аутентификации, обработки сессий. Sinatra использует
 многие из этих компонентов автоматически, основываясь на конфигурации, чтобы вам не приходилось
 регистрировать/использовать (+use+) их вручную.
@@ -829,16 +955,15 @@ Rack распространяется с различными стандартн
     end
   end
 
-Заметьте: Встроенные модули Sinatra::Test и Sinatra::TestHarness являются
+Обратите внимание: Встроенные модуль Sinatra::Test и класс Sinatra::TestHarness являются
-устаревшими, начиная с 0.9.2 релиза.
+устаревшими, начиная с релиза 0.9.2.
 
-== Sinatra::Base - Подпрограммы, библиотеки и модульные приложения
+== Sinatra::Base — "прослойки", библиотеки и модульные приложения
 
 Описание своего приложения самым простейшим способом (с помощью DSL верхнего уровня, как в примерах выше)
-работает отлично для крохотных приложений, но имеет множество недостатков, когда надо
+работает отлично для крохотных приложений, но имеет множество недостатков, когда надо создать компоненты, такие как
-создать компоненты, такие как Rack
+Rack middleware ("прослойки"), Rails metal, простые библиотеки с серверными компонентами,
-middleware, Rails metal, простые библиотеки с серверными компонентами,
+расширения Sinatra.
-Sinatra расширения.
 DSL верхнего уровня загрязняет пространство имен <tt>Object</tt> и подразумевает стиль конфигурации
 микро-приложения (например, единый файл приложения, ./public и
 ./views директории, создание логов, страницу деталей об исключениях 
@@ -855,13 +980,6 @@ DSL верхнего уровня загрязняет пространство
     end
   end
 
-MyApp класс является независимым Rack компонентом, который может исполнять роли
-Rack подпрограммы, Rack приложения, Rails metal. Вы можете +use+ (использовать) или
-+run+ (запустить) этот класс из rackup файла +config.ru+; или контролировать серверную
-часть из библиотеки:
-
-   MyApp.run! :host => 'localhost', :port => 9090
-
 Методы, доступные Sinatra::Base сабклассам идентичны тем, что доступны
 в DSL верхнего уровня. Большинство приложений верхнего уровня могут быть
 конвертированы в Sinatra::Base компоненты с помощью двух модификаций:
@@ -874,10 +992,68 @@ Rack подпрограммы, Rack приложения, Rails metal. Вы мо
 Смотрите {Опции и Конфигурация}[http://www.sinatrarb.com/configuration.html] для детальной информации
 об опциях и их поведении.
 
-=== Использование Sinatra как подпрограммы
+=== Запуск модульных приложений
 
-Не только сама Sinatra может использовать подпрограммы Rack, любое Sinatra приложение
+Есть два общепринятых способа запускать модульные приложения: запуск напрямую с помощью <tt>run!</tt>:
-само может быть добавлено к любому Rack эндпоинту в качестве подпрограммы. Этим эндпоинтом
+
+  # my_app.rb
+  require 'sinatra/base'
+
+  class MyApp < Sinatra::Base
+    # ... здесь код приложения ...
+
+    # запускаем сервер, если исполняется текущий файл
+    run! if app_file == $0
+  end
+
+И запускаем с помощью:
+
+  ruby my_app.rb
+
+Или с помощью конфигурационного файла <tt>config.ru</tt>, который позволяет использовать любой
+Rack-совместимый сервер приложений.
+
+  # config.ru
+  require 'my_app'
+  run MyApp
+
+Запускаем:
+
+  rackup -p 4567
+
+=== Запуск "классических" приложений с config.ru
+
+Файл приложения:
+
+  # app.rb
+  require 'sinatra'
+
+  get '/' do
+    'Hello world!'
+  end
+
+И соответствующий <tt>config.ru</tt>:
+
+  require 'app'
+  run Sinatra::Application
+
+=== Когда использовать config.ru?
+
+Вот несколько причин, по которым вы, возможно, захотите использовать <tt>config.ru</tt>:
+
+* вы хотите разворачивать свое приложение на различных Rack-совместимых серверах (Passenger, Unicorn,
+  Heroku, ...).
+* вы хотите использовать более одного сабкласса <tt>Sinatra::Base</tt>.
+* вы хотите использовать Sinatra только в качестве "прослойки" Rack.
+
+<b>Совсем необязательно переходить на использование <tt>config.ru</tt> лишь потому, что вы стали
+использовать модульный стиль приложения. И необязательно использовать модульный стиль, чтобы
+запускать приложение с помощью <tt>config.ru</tt>.</b>
+
+=== Использование Sinatra в качестве "прослойки"
+
+Не только сама Sinatra может использовать "прослойки" Rack, но и любое Sinatra приложение
+само может быть добавлено к любому Rack эндпоинту в качестве "прослойки". Этим эндпоинтом
 может быть другое Sinatra приложение, или приложение, основанное на Rack (Rails/Ramaze/Camping/...).
 
   require 'sinatra/base'
@@ -897,7 +1073,7 @@ Rack подпрограммы, Rack приложения, Rails metal. Вы мо
   end
   
   class MyApp < Sinatra::Base
-    # подпрограмма будет запущена перед фильтрами
+    # "прослойка" будет запущена перед фильтрами
     use LoginScreen
     
     before do
@@ -1014,31 +1190,69 @@ Sinatra приложения могут быть запущены напряму
 
 == На острие
 
-Если вы хотите использовать новейший код Sinatra, то создайте локальный
+Если вы хотите использовать самый последний код Sinatra, не бойтесь запускать
-клон и запускайте свое приложение с <tt>sinatra/lib</tt> директорией
+свое приложение вместе с master бранчем Sinatra, он весьма стабилен.
-в <tt>LOAD_PATH</tt>:
+
+Мы также время от времени выпускаем предварительные версии, так что вы можете делать так:
+
+  gem install sinatra --pre
+
+Чтобы воспользоваться некоторыми самыми последними возможностям.
+
+=== С помощью Bundler
+
+Если вы хотите запускать свое приложение с последней версией Sinatra, то
+рекомендуем использовать {Bundler}[http://gembundler.com/].
+
+Сначала установите Bundler, если у вас его еще нет:
+
+  gem install bundler
+
+Затем создайте файл +Gemfile+ в директории вашего проекта:
+
+  source :rubygems
+  gem 'sinatra', :git => "git://github.com/sinatra/sinatra.git"
+
+  # другие зависимости
+  gem 'haml'                    # например, если используете haml
+  gem 'activerecord', '~> 3.0'  # может быть, вам нужен и ActiveRecord 3.x
+
+Обратите внимание, вам нужно будет указывать все зависимости вашего приложения
+в этом файле. Однако, непосредственные зависимости Sinatra (Rack и Tilt) Bundler
+автоматически скачает и добавит.
+
+Теперь вы можете запускать свое приложение примерно так:
+
+  bundle exec ruby myapp.rb
+
+=== Вручную
+
+Создайте локальный клон репозитория и запускайте свое приложение с <tt>sinatra/lib</tt>
+директорией в <tt>LOAD_PATH</tt>:
 
   cd myapp
   git clone git://github.com/sinatra/sinatra.git
   ruby -Isinatra/lib myapp.rb
 
-Также вы можете добавить <tt>sinatra/lib</tt> директорию в
-<tt>LOAD_PATH</tt> приложения:
-
-  $LOAD_PATH.unshift File.dirname(__FILE__) + '/sinatra/lib'
-  require 'rubygems'
-  require 'sinatra'
-
-  get '/about' do
-    "I'm running version " + Sinatra::VERSION
-  end
-
 Чтобы обновить исходники Sinatra:
 
-  cd myproject/sinatra
+  cd myapp/sinatra
   git pull
 
-== Больше информации
+=== Установка глобально
+
+Вы можете самостоятельно собрать gem:
+
+  git clone git://github.com/sinatra/sinatra.git
+  cd sinatra
+  rake sinatra.gemspec
+  rake install
+
+Если вы устанавливаете пакеты (gem) от пользователя root, то вашим последним шагом должна быть команда
+
+  sudo rake install
+
+== Дальнейшее чтение
 
 * {Вебсайт проекта}[http://www.sinatrarb.com/] - Дополнительная документация,
   новости и ссылки на другие ресурсы.