sinatra 1.2.0.a → 1.2.0.c

data/AUTHORS

@@ -36,6 +36,8 @@ Sinatra would not be possible:
 * Rick Olson (technoweenie) for the killer plug at RailsConf '08.
 * Steven Garcia for the amazing custom artwork you see on 404's and 500's
 * Pat Nakajima (nakajima) for fixing non-nested params in nested params Hash's.
+* Konstantin Haase for his hard work and ongoing commitment to improving 
+  Sinatra, for 1.1.0, 1.2.0 and beyond..
 
 and last but not least:
 

data/CHANGES

@@ -6,7 +6,71 @@
  * The `markaby` rendering method now allows passing a block, making inline
    usage possible. Requires Tilt 1.2 or newer. (Konstantin Haase)
 
-= 1.1.1 / Not Yet Released
+ * All render methods now take a `:layout_engine` option, allowing to use a
+   layout in a different template language. Even more useful than using this
+   directly (`erb :index, :layout_engine => :haml`) is setting this globally for
+   a template engine that otherwise does not support layouts, like Markdown or
+   Textile (`set :markdown, :layout_engine => :erb`). (Konstantin Haase)
+
+ * Before and after filters now support conditions, both with and without
+   patterns (`before '/api/*', :agent => /Songbird/`). (Konstantin Haase)
+
+ * Added a `url` helper method which constructs absolute URLs. Copes with
+   reverse proxies and Rack handlers correctly. Aliased to `to`, so you can
+   write `redirect to('/foo')`. (Konstantin Haase)
+
+ * If running on 1.9, patterns for routes and filters now support named
+   captures: `get(%r{/hi/(?<name>[^/?#]+)}) { "Hi #{params['name']}" }`.
+   (Steve Price)
+
+ * All rendering methods now take a `:scope` option, which renders them in
+   another context. Note that helpers and instance variables will be
+   unavailable if you use this feature. (Paul Walker)
+
+ * The behavior of `redirect` can now be configured with `absolute_redirects`
+   and `prefixed_redirects`. (Konstantin Haase)
+
+ * `send_file` now allows overriding the Last-Modified header, which defaults
+   to the file's mtime, by passing a `:last_modified` option. (Konstantin Haase)
+
+ * You can use your own template lookup method by defining `find_template`.
+   This allows, among other things, using more than one views folder.
+   (Konstantin Haase)
+
+ * Largely improved documentation. (burningTyger, Vasily Polovnyov, Gabriel
+   Andretta, Konstantin Haase)
+
+ * Improved error handling. (cactus, Konstantin Haase)
+
+ * Skip missing template engines in tests correctly. (cactus)
+
+ * Sinatra now ships with a Gemfile for development dependencies, since it eases
+   supporting different platforms, like JRuby. (Konstantin Haase)
+
+= 1.1.3 / Not Yet Released
+
+ * Fixed issues with `user_agent` condition if the user agent header is missing.
+   (Konstantin Haase)
+
+ * Fix some routing tests that have been skipped by accident (Ross A. Baker)
+
+ * Fix rendering issues with Builder and Nokogiri (Konstantin Haase)
+
+ * Replace last_modified helper with better implementation. (cactus,
+   Konstantin Haase)
+
+ * Fix issue with charset not being set when using `provides` condition.
+   (Konstantin Haase)
+
+ * Fix issue with `render` not picking up all alternative file extensions for
+   a rendering engine - it was not possible to register ".html.erb" without
+   tricks. (Konstantin Haase)
+
+= 1.1.2 / 2010-10-25
+
+Like 1.1.1, but with proper CHANGES file.
+
+= 1.1.1 / 2010-10-25
 
  * README has been translated to Russian (Nickolay Schwarz, Vasily Polovnyov)
    and Portuguese (Luciano Sousa).
@@ -34,6 +98,10 @@
  * Headers set by cache_control now always set max_age as an Integer, making
    sure it is compatible with RFC2616. (Konstantin Haase)
 
+ * Further improved handling of string encodings on Ruby 1.9, templates now
+   honor default_encoding and URLs support unicode characters. (Konstantin
+   Haase)
+
 = 1.1.0 / 2010-10-24
 
  * Before and after filters now support pattern matching, including the

data/Gemfile

@@ -0,0 +1,35 @@
+# Why use bundler?
+# Well, not all development dependencies install on all rubies. Moreover, `gem 
+# install sinatra --development` doesn't work, as it will also try to install
+# development dependencies of our dependencies, and those are not conflict free.
+# So, here we are, `bundle install`.
+#
+# If you have issues with on gem: `bundle install --without-coffee-script`.
+
+source :rubygems
+gemspec
+
+gem 'rake'
+gem 'rack-test', '>= 0.5.6'
+
+gem 'haml', '>= 3.0', :group => 'haml'
+gem 'builder', :group => 'builder'
+gem 'erubis', :group => 'erubis'
+gem 'less', :group => 'less'
+gem 'liquid', :group => 'liquid'
+gem 'RedCloth', :group => 'redcloth'
+gem 'rdoc', :group => 'rdoc'
+gem 'nokogiri', :group => 'nokogiri'
+gem 'slim', :group => 'slim'
+
+gem 'coffee-script', '>= 2.0', :group => 'coffee-script'
+
+platforms :ruby do
+  gem 'rdiscount', :group => 'rdiscount'
+end
+
+platforms :ruby_18, :jruby do
+  gem 'json', :group => 'coffee-script'
+  gem 'markaby', :group => 'markaby'
+  gem 'radius', :group => 'radius'
+end

data/Gemfile.lock

@@ -0,0 +1,74 @@
+PATH
+  remote: .
+  specs:
+    sinatra (1.2.0.a)
+      rack (~> 1.1)
+      tilt (>= 1.2.2, < 2.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    RedCloth (4.2.7)
+    RedCloth (4.2.7-java)
+    abstract (1.0.0)
+    builder (3.0.0)
+    coffee-script (2.1.3)
+      coffee-script-source
+    coffee-script-source (1.0.1)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    haml (3.0.25)
+    json (1.5.1)
+    json (1.5.1-java)
+    less (1.2.21)
+      mutter (>= 0.4.2)
+      treetop (>= 1.4.2)
+    liquid (2.2.2)
+    markaby (0.7.1)
+      builder (>= 2.0.0)
+    mutter (0.5.3)
+    nokogiri (1.4.4)
+    nokogiri (1.4.4-java)
+      weakling (>= 0.0.3)
+    polyglot (0.3.1)
+    rack (1.2.1)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    radius (0.6.1)
+    rake (0.8.7)
+    rdiscount (1.6.8)
+    rdoc (3.5.3)
+    shotgun (0.8)
+      rack (>= 1.0)
+    slim (0.9.0)
+      temple (~> 0.1.7)
+      tilt (~> 1.2)
+    temple (0.1.7)
+    tilt (1.2.2)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    weakling (0.0.4-java)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  RedCloth
+  builder
+  coffee-script (>= 2.0)
+  erubis
+  haml (>= 3.0)
+  json
+  less
+  liquid
+  markaby
+  nokogiri
+  rack-test (>= 0.5.6)
+  radius
+  rake
+  rdiscount
+  rdoc
+  shotgun (~> 0.6)
+  sinatra!
+  slim

data/README.de.rdoc

@@ -177,7 +177,7 @@ Renderingmethoden rendern jeden String direkt.
 
 Das haml gem wird benötigt, um Haml-Templates rendern zu können:
 
-  ## haml muss eingebunden werden
+  # haml muss eingebunden werden
   require 'haml'
 
   get '/' do
@@ -199,7 +199,7 @@ und individuell überschrieben werden.
 
 === Erb-Templates
 
-  ## erb muss eingebunden werden
+  # erb muss eingebunden werden
   require 'erb'
 
   get '/' do
@@ -212,7 +212,7 @@ Dieser Code rendert <tt>./views/index.erb</tt>.
 
 Das erubis gem wird benötigt, um Erubis-Templates rendern zu können:
 
-  ## erbubis muss eingebunden werden
+  # erbubis muss eingebunden werden
   require 'erubis'
 
   get '/' do
@@ -225,7 +225,7 @@ Dieser Code rendert <tt>./views/index.erubis</tt>.
 
 Das buidler gem wird benötigt, um Builder-Templates rendern zu können:
 
-  ## builder muss eingebunden werden
+  # builder muss eingebunden werden
   require 'builder'
 
   get '/' do
@@ -238,7 +238,7 @@ Dieser Code rendert <tt>./views/index.builder</tt>.
 
 Das nokogiri gem wird benötigt, um Nokogiri-Templates rendern zu können:
 
-  ## nokogiri muss eingebunden werden
+  # nokogiri muss eingebunden werden
   require 'nokogiri'
 
   get '/' do
@@ -251,7 +251,7 @@ Dieser Code rendert <tt>./views/index.nokogiri</tt>.
 
 Das haml gem wird benötigt, um SASS-Templates rendern zu können:
 
-  ## sass muss eingebunden werden
+  # sass muss eingebunden werden
   require 'sass'
 
   get '/stylesheet.css' do
@@ -275,7 +275,7 @@ und individuell überschrieben werden.
 
 Das haml gem wird benötigt, um SCSS-Templates rendern zu können:
 
-  ## sass muss eingebunden werden
+  # sass muss eingebunden werden
   require 'sass'
 
   get '/stylesheet.css' do
@@ -299,7 +299,7 @@ und individuell überschrieben werden.
 
 Das less gem wird benötigt, um Less-Templates rendern zu können:
 
-  ## less muss eingebunden werden
+  # less muss eingebunden werden
   require 'less'
 
   get '/stylesheet.css' do
@@ -312,7 +312,7 @@ Dieser Code rendert <tt>./views/stylesheet.less</tt>.
 
 Das liquid gem wird benötigt, um Liquid-Templates rendern zu können:
 
-  ## liquid muss eingebunden werden
+  # liquid muss eingebunden werden
   require 'liquid'
 
   get '/' do
@@ -330,7 +330,7 @@ aufrufen kann, will man nahezu in allen Fällen +locals+ übergeben:
 
 Das rdiscount gem wird benötigt, um Markdown-Templates rendern zu können:
 
-  ## rdiscount muss eingebunden werden
+  # rdiscount muss eingebunden werden
   require "rdiscount"
 
   get '/' do
@@ -356,7 +356,7 @@ aufzurufen:
 
 Das RedCloth gem wird benötigt, um Textile-Templates rendern zu können:
 
-  ## redcloth muss eingebunden werden
+  # redcloth muss eingebunden werden
   require "redcloth"
 
   get '/' do
@@ -381,7 +381,7 @@ aufzurufen:
 
 Das rdoc gem wird benötigt, um RDoc-Templates rendern zu können:
 
-  ## RDoc muss eingebunden werden
+  # RDoc muss eingebunden werden
   require "rdoc"
 
   get '/' do
@@ -406,7 +406,7 @@ aufzurufen:
 
 Das radius gem wird benötigt, um Radius-Templates rendern zu können:
 
-  ## radius muss eingebunden werden
+  # radius muss eingebunden werden
   require 'radius'
 
   get '/' do
@@ -424,7 +424,7 @@ aufrufen kann, will man nahezu in allen Fällen +locals+ übergeben:
 
 Das markaby gem wird benötigt, um Markaby-Templates rendern zu können:
 
-  ## markaby muss eingebunden werden
+  # markaby muss eingebunden werden
   require 'markaby'
 
   get '/' do
@@ -437,7 +437,7 @@ Dieser Code rendert <tt>./views/index.mab</tt>.
 
 Das slim gem wird benötigt, um Slim-Templates rendern zu können:
 
-  ## slim muss eingebunden werden
+  # slim muss eingebunden werden
   require 'slim'
 
   get '/' do
@@ -450,7 +450,7 @@ Dieser Code rendert <tt>./views/index.slim</tt>.
 
 Das coffee-script gem und das `coffee`-Programm werden benötigt, um CoffeScript-Templates rendern zu können:
 
-  ## coffee-script muss eingebunden werden
+  # coffee-script muss eingebunden werden
   require 'coffee-script'
 
   get '/application.js' do

data/README.es.rdoc

@@ -151,7 +151,7 @@ De esa manera podemos, por ejemplo, implementar fácilmente un streaming:
 
     get('/') { Stream.new }
 
-== Archivos estáticos
+== Archivos Estáticos
 
 Los archivos estáticos son servidos desde el directorio público
 <tt>./public</tt>. Podés especificar una ubicación diferente ajustando la
@@ -178,9 +178,9 @@ les pase como argumento.
 
 === Plantillas Haml
 
-La gem/librería haml es necesaria para para renderizar plantillas HAML:
+La gem/librería <tt>haml</tt> es necesaria para para renderizar plantillas HAML:
 
-  ## Vas a necesitar requerir haml en tu app
+  # Vas a necesitar requerir haml en tu app
   require 'haml'
 
   get '/' do
@@ -202,7 +202,7 @@ y reemplazadas individualmente.
 
 === Plantillas Erb
 
-  ## Vas a necesitar requerir erb en tu app
+  # Vas a necesitar requerir erb en tu app
   require 'erb'
 
   get '/' do
@@ -211,24 +211,36 @@ y reemplazadas individualmente.
 
 Renderiza <tt>./views/index.erb</tt>
 
-=== Erubis
+=== Plantillas Erubis
 
-La gem/librería erubis es necesaria para renderizar plantillas erubis:
+La gem/librería <tt>erubis</tt> es necesaria para renderizar plantillas Erubis:
 
-  ## Vas a necesitar requerir erubis en tu app
+  # Vas a necesitar requerir erubis en tu app
   require 'erubis'
 
   get '/' do
     erubis :index
   end
 
-Renderiza <tt>./views/index.erubis</tt>
+Renderiza <tt>./views/index.erubis</tt>.
+
+También es posible reemplazar Erb con Erubis:
+
+  require 'erubis'
+  Tilt.register :erb, Tilt[:erubis]
+
+  get '/' do
+    erb :index
+  end
+
+Renderiza <tt>./views/index.erb</tt> con Erubis.
 
 === Plantillas Builder
 
-La gem/librería builder es necesaria para renderizar plantillas builder:
+La gem/librería <tt>builder</tt> es necesaria para renderizar plantillas
+builder:
 
-  ## Vas a necesitar requerir builder en tu app
+  # Vas a necesitar requerir builder en tu app
   require 'builder'
 
   get '/' do
@@ -239,9 +251,10 @@ Renderiza <tt>./views/index.builder</tt>.
 
 === Plantillas Nokogiri
 
-La gem/librería nokogiri es necesaria para renderizar plantillas nokogiri:
+La gem/librería <tt>nokogiri</tt> es necesaria para renderizar plantillas
+nokogiri:
 
-  ## Vas a necesitar requerir nokogiri en tu app
+  # Vas a necesitar requerir nokogiri en tu app
   require 'nokogiri'
 
   get '/' do
@@ -252,9 +265,10 @@ Renderiza <tt>./views/index.nokogiri</tt>.
 
 === Plantillas Sass
 
-La gem/librería haml es necesaria para renderizar plantillas Sass:
+La gem/librería <tt>haml</tt> o <tt>sass</tt> es necesaria para renderizar
+plantillas Sass:
 
-  ## Vas a necesitar requerir haml o sass en tu app
+  # Vas a necesitar requerir haml o sass en tu app
   require 'sass'
 
   get '/stylesheet.css' do
@@ -276,9 +290,10 @@ y reemplazadas individualmente.
 
 === Plantillas Scss
 
-La gem/librería haml es necesaria para renderizar plantillas Scss:
+La gem/librería <tt>haml</tt> o <tt>sass</tt>es necesaria para renderizar
+plantillas Scss:
 
-  ## Vas a necesitar requerir haml o sass en tu app
+  # Vas a necesitar requerir haml o sass en tu app
   require 'sass'
 
   get '/stylesheet.css' do
@@ -300,9 +315,9 @@ y reemplazadas individualmente.
 
 === Plantillas Less
 
-La gem/librería less es necesaria para renderizar plantillas Less:
+La gem/librería <tt>less</tt> es necesaria para renderizar plantillas Less:
 
-  ## Vas a necesitar requerir less en tu app
+  # Vas a necesitar requerir less en tu app
   require 'less'
 
   get '/stylesheet.css' do
@@ -313,9 +328,9 @@ Renderiza <tt>./views/stylesheet.less</tt>.
 
 === Plantillas Liquid
 
-La gem/librería liquid es necesaria para renderizar plantillas Liquid:
+La gem/librería <tt>liquid</tt> es necesaria para renderizar plantillas Liquid:
 
-  ## Vas a necesitar requerir liquid en tu app
+  # Vas a necesitar requerir liquid en tu app
   require 'liquid'
 
   get '/' do
@@ -331,9 +346,10 @@ plantilla Liquid, casi siempre vas a querer pasarle locales:
 
 === Plantillas Markdown
 
-La gem/librería rdiscount es necesaria para renderizar plantillas Markdown:
+La gem/librería <tt>rdiscount</tt> es necesaria para renderizar plantillas
+Markdown:
 
-  ## Vas a necesitar requerir rdiscount en tu app
+  # Vas a necesitar requerir rdiscount en tu app
   require "rdiscount"
 
   get '/' do
@@ -348,17 +364,53 @@ generalmente vas a usarlo en combinación con otro motor de renderizado:
 
   erb :resumen, :locals => { :texto => markdown(:introduccion) }
 
-Tené en cuenta que también podés llamar al método markdown desde otras
+Tené en cuenta que también podés llamar al método +markdown+ desde otras
 plantillas:
 
   %h1 Hola Desde Haml!
   %p= markdown(:saludos)
 
-=== Plantilla Textile
+Como no podés utilizar Ruby desde Markdown, no podés usar layouts escritos en
+Markdown. De todos modos, es posible usar un motor de renderizado para el
+layout distinto al de la plantilla pasando la opción `:layout_engine`:
+
+  get '/' do
+    markdown :index, :layout_engine => :erb
+  end
+
+Renderiza <tt>./views/index.md</tt> con el layout <tt>./views/layout.erb</tt>.
+
+Recordá que podés asignar las opciones de renderizado globalmente:
+
+  set :markdown, :layout_engine => :haml, :layout => :post
 
-La gem/librería RedCloth es necesaria para renderizar plantillas Textile:
+  get '/' do
+    markdown :index
+  end
 
-  ## Vas a necesitar requerir redcloth en tu app
+Renderiza <tt>./views/index.md</tt> (o cualquier otra plantilla Markdown) con
+el layout <tt>./views/post.haml</tt>.
+
+También es posible parsear Markdown con BlueCloth en lugar de RDiscount:
+
+  require 'bluecloth'
+
+  Tilt.register 'markdown', BlueClothTemplate
+  Tilt.register 'mkd',      BlueClothTemplate
+  Tilt.register 'md',       BlueClothTemplate
+
+  get '/' do
+    markdown :index
+  end
+
+Renderiza <tt>./views/index.md</tt> con BlueCloth.
+
+=== Plantillas Textile
+
+La gem/librería <tt>RedCloth</tt> es necesaria para renderizar plantillas
+Textile:
+
+  # Vas a necesitar requerir redcloth en tu app
   require "redcloth"
 
   get '/' do
@@ -372,17 +424,39 @@ generalmente vas a usarlo en combinación con otro motor de renderizado:
 
   erb :resumen, :locals => { :texto => textile(:introduccion) }
 
-Tené en cuenta que también podés llamar al método textile desde otras
+Tené en cuenta que también podés llamar al método +textile+ desde otras
 plantillas:
 
   %h1 Hola Desde Haml!
   %p= textile(:saludos)
 
+Como no podés utilizar Ruby desde Textile, no podés usar layouts escritos en
+Textile. De todos modos, es posible usar un motor de renderizado para el
+layout distinto al de la plantilla pasando la opción `:layout_engine`:
+
+  get '/' do
+    textile :index, :layout_engine => :erb
+  end
+
+Renderiza <tt>./views/index.textile</tt> con el layout
+<tt>./views/layout.erb</tt>.
+
+Recordá que podés asignar las opciones de renderizado globalmente:
+
+  set :textile, :layout_engine => :haml, :layout => :post
+
+  get '/' do
+    textile :index
+  end
+
+Renderiza <tt>./views/index.textile</tt> (o cualquier otra plantilla Textile)
+con el layout <tt>./views/post.haml</tt>.
+
 === Plantillas RDoc
 
-La gem/librería RDoc es necesaria para renderizar plantillas RDoc:
+La gem/librería <tt>rdoc</tt> es necesaria para renderizar plantillas RDoc:
 
-  ## Vas a necesitar requerir rdoc en tu app
+  # Vas a necesitar requerir rdoc en tu app
   require "rdoc"
 
   get '/' do
@@ -396,17 +470,38 @@ generalmente vas a usarlo en combinación con otro motor de renderizado:
 
   erb :resumen, :locals => { :texto => rdoc(:introduccion) }
 
-Tené en cuenta que también podés llamar al método rdoc desde otras
+Tené en cuenta que también podés llamar al método +rdoc+ desde otras
 plantillas:
 
   %h1 Hola Desde Haml!
   %p= rdoc(:saludos)
 
+Como no podés utilizar Ruby desde RDoc, no podés usar layouts escritos en RDoc.
+De todos modos, es posible usar un motor de renderizado para el layout distinto
+al de la plantilla pasando la opción `:layout_engine`:
+
+  get '/' do
+    rdoc :index, :layout_engine => :erb
+  end
+
+Renderiza <tt>./views/index.rdoc</tt> con el layout <tt>./views/layout.erb</tt>.
+
+Recordá que podés asignar las opciones de renderizado globalmente:
+
+  set :rdoc, :layout_engine => :haml, :layout => :post
+
+  get '/' do
+    rdoc :index
+  end
+
+Renderiza <tt>./views/index.rdoc</tt> (o cualquier otra plantilla RDoc) con el
+layout <tt>./views/post.haml</tt>.
+
 === Plantillas Radius
 
-La gem/librería radius es necesaria para renderizar plantillas Radius:
+La gem/librería <tt>radius</tt> es necesaria para renderizar plantillas Radius:
 
-  ## Vas a necesitar requerir radius en tu app
+  # Vas a necesitar requerir radius en tu app
   require 'radius'
 
   get '/' do
@@ -422,9 +517,10 @@ plantilla Radius, casi siempre vas a querer pasarle locales:
 
 === Plantillas Markaby
 
-La gem/librería markaby es necesaria para renderizar plantillas Markaby:
+La gem/librería <tt>markaby</tt> es necesaria para renderizar plantillas
+Markaby:
 
-  ## Vas a necesitar requerir markaby en tu app
+  # Vas a necesitar requerir markaby en tu app
   require 'markaby'
 
   get '/' do
@@ -433,7 +529,7 @@ La gem/librería markaby es necesaria para renderizar plantillas Markaby:
 
 Renderiza <tt>./views/index.mab</tt>.
 
-Si tenés Tilt 1.2 o posterior, podés usar markaby inline:
+También podés usar Markaby inline:
 
   get '/' do
     markaby { h1 "Bienvenido!" }
@@ -442,9 +538,9 @@ Si tenés Tilt 1.2 o posterior, podés usar markaby inline:
 
 === Plantillas Slim
 
-La gem/librería slim es necesaria para renderizar plantillas Slim:
+La gem/librería <tt>slim</tt> es necesaria para renderizar plantillas Slim:
 
-  ## Vas a necesitar requerir slim en tu app
+  # Vas a necesitar requerir slim en tu app
   require 'slim'
 
   get '/' do
@@ -455,10 +551,16 @@ Renderiza <tt>./views/index.slim</tt>.
 
 === Plantillas CoffeeScript
 
-La gem/librería coffee-script y el binario `coffee` son necesarios para
-renderizar plantillas CoffeeScript:
+La gem/librería <tt>coffee-script</tt> y al menos <b>una</b> de las siguientes
+opciones para ejecutar JavaScript:
+
+* +node+ (de Node.js) en tu path
+* utilizar OSX
+* la gem/librería +therubyracer+
+
+son necesarios para renderizar plantillas CoffeeScript:
 
-  ## Vas a necesitar requerir coffee-script en tu app
+  # Vas a necesitar requerir coffee-script en tu app
   require 'coffee-script'
 
   get '/application.js' do
@@ -467,13 +569,13 @@ renderizar plantillas CoffeeScript:
 
 Renderiza <tt>./views/application.coffee</tt>.
 
-=== Plantillas Inline
+=== Plantillas Embebidas
 
   get '/' do
     haml '%div.titulo Hola Mundo'
   end
 
-Renderiza el template contenido en el string.
+Renderiza el template embebido en el string.
 
 === Accediendo a Variables en Plantillas
 
@@ -539,28 +641,39 @@ Las plantillas también pueden ser definidas usando el método top-level
   end
 
 Si existe una plantilla con el nombre "layout", va a ser usada cada vez que
-una plantilla es renderizada. Podés desactivar los layouts pasando
-<tt>:layout => false</tt>.
+una plantilla es renderizada. Podés desactivar los layouts individualmente
+pasando <tt>:layout => false</tt> o globalmente con
+<tt>set :haml, :layout => false</tt>.
 
   get '/' do
     haml :index, :layout => !request.xhr?
   end
 
-== Ayudantes
+=== Asociando Extensiones de Archivo
 
-Usá el método top-level <tt>helpers</tt> para definir métodos ayudantes que
-pueden ser utilizados dentro de los manejadores de rutas y las plantillas:
+Para asociar una extensión de archivo con un motor de renderizado, usá
+<tt>Tilt.register</tt>. Por ejemplo, si querés usar la extensión +tt+ para
+las plantillas Textile, podés hacer lo siguiente:
+
+  Tilt.register :tt, Tilt[:textile]
+
+=== Agregando Tu Propio Motor de Renderizado
+
+Primero, registrá tu motor con Tilt, y después, creá tu método de renderizado:
+
+  Tilt.register :mipg, MiMotorParaPlantillaGenial
 
   helpers do
-    def bar(nombre)
-      "#{nombre}bar"
-    end
+    def mypg(*args) render(:mypg, *args) end
   end
 
-  get '/:nombre' do
-    bar(params[:nombre])
+  get '/' do
+    mypg :index
   end
 
+Renderiza <tt>./views/index.mypg</tt>. Mirá https://github.com/rtomayko/tilt
+para aprender más de Tilt.
+
 == Filtros
 
 Los filtros before son evaluados antes de cada petición dentro del mismo
@@ -587,6 +700,10 @@ filtros after:
     puts response.status
   end
 
+Nota: A menos que usés el método `body` en lugar de simplemente devolver un
+string desde una ruta, el cuerpo de la respuesta no va a estar disponible en
+un filtro after, debido a que todavía no se ha generado.
+
 Los filtros aceptan un patrón opcional, que cuando está presente causa que los
 mismos sean evaluados únicamente si el path de la petición coincide con ese
 patrón:
@@ -609,7 +726,22 @@ Al igual que las rutas, los filtros también aceptan condiciones:
     # ...
   end
 
-== Interrupción
+== Ayudantes
+
+Usá el método top-level <tt>helpers</tt> para definir métodos ayudantes que
+pueden ser utilizados dentro de los manejadores de rutas y las plantillas:
+
+  helpers do
+    def bar(nombre)
+      "#{nombre}bar"
+    end
+  end
+
+  get '/:nombre' do
+    bar(params[:nombre])
+  end
+
+=== Interrupción
 
 Para detener inmediatamente una petición dentro de un filtro o una ruta usá:
 
@@ -631,7 +763,7 @@ Con cabeceras:
 
   halt 402, { 'Content-Type' => 'text/plain' }, 'venganza'
 
-== Paso
+=== Paso
 
 Una ruta puede pasarle el procesamiento a la siguiente ruta que coincida con
 la petición usando <tt>pass</tt>:
@@ -648,7 +780,66 @@ la petición usando <tt>pass</tt>:
 Se sale inmediatamente del bloque de la ruta y se le pasa el control a la
 siguiente ruta que coincida. Si no coincide ninguna ruta, se devuelve un 404.
 
-== Accediendo al objeto de la petición
+=== Asignando el cuerpo y el código de estado de una respuesta
+
+Es posible, y se recomienda, asignar el código de estado y el cuerpo de una
+respuesta con el valor de retorno de una ruta.  De cualquier manera, en varios
+escenarios, puede que sea conveniente asignar el cuerpo en un punto arbitrario
+del flujo de ejecución con el método `body`.  A partir de ahí, podés usar ese
+mismo método para acceder al cuerpo de la respuesta:
+
+  get '/foo' do
+    body "bar"
+  end
+
+  after do
+    puts body
+  end
+
+También es posible pasarle un bloque a body, que será ejecutado por el rack
+handler (podés usar esto para implementar streaming, mirá
+[Valores de retorno](#Valores%20de%20retorno)).
+
+De manera similar, también podés asignar el código de estado:
+
+  get '/foo' do
+    status 418
+    halt "I'm a teapot"
+  end
+
+=== Redirección del Navegador
+
+Podés redireccionar al navegador con el método `redirect`:
+
+  get '/foo' do
+    redirect '/bar'
+  end
+
+Cualquier parámetro adicional se utiliza de la misma manera que los argumentos
+pasados a `halt`:
+
+  redirect '/bar', 303
+  redirect '/bar', 'te confundiste de lugar, compañero'
+
+Para pasar argumetnos con una redirección, podés agregarlo a la cadena de
+búsqueda:
+
+  redirect '/bar?suma=42'
+
+O usar una sesión:
+
+  enable :session
+
+  get '/foo' do
+    session[:secreto] = 'foo'
+    redirect '/bar'
+  end
+
+  get '/bar' do
+    session[:secreto]
+  end
+
+=== Accediendo al objeto de la petición
 
 El objeto de la petición entrante puede ser accedido desde el nivel de la
 petición (filtros, rutas y manejadores de errores) a través del método
@@ -718,7 +909,7 @@ Ejecutar cuando el entorno es <tt>:production</tt> o <tt>:test</tt>:
     ...
   end
 
-== Manejo de errores
+== Manejo de Errores
 
 Los manejadores de errores se ejecutan dentro del mismo contexto que las rutas
 y los filtros before, lo que significa que podés usar, por ejemplo,
@@ -884,13 +1075,6 @@ etc.). Ahí es donde Sinatra::Base entra en el juego:
     end
   end
 
-La clase MiApp es un componente Rack independiente que puede actuar como Rack
-middleware, una aplicación Rack, o Rails metal. Podés usar (con +use+) o
-ejecutar (con +run+) esta clase desde un archivo rackup +config.ru+; o,
-controlar un componente de servidor provisto como una librería:
-
-   MiApp.run! :host => 'localhost', :port => 9090
-
 Las subclases de Sinatra::Base tienen disponibles exactamente los mismos
 métodos que los provistos por el DSL de top-level. La mayoría de las
 aplicaciones top-level se pueden convertir en componentes Sinatra::Base con
@@ -907,6 +1091,64 @@ desactivadas por defecto, incluyendo el servidor incorporado. Mirá
 {Opciones y Configuraciones}[http://sinatra.github.com/configuration.html]
 para detalles sobre las opciones disponibles y su comportamiento.
 
+=== Sirviendo una Aplicación Modular
+
+Las dos opciones más comunes para iniciar una aplicación modular son, iniciarla
+activamente con <tt>run!</tt>:
+
+  # mi_app.rb
+  require 'sinatra/base'
+
+  class MiApp < Sinatra::Base
+    # ... código de la app  ...
+
+    # iniciar el servidor si el archivo fue ejecutado directamente
+    run! if app_file == $0
+  end
+
+Iniciar con:
+
+  ruby mi_app.rb
+
+O, con un archivo <tt>config.ru</tt>, que permite usar cualquier handler Rack:
+
+  # config.ru
+  require 'mi_app'
+  run MiApp
+
+Después ejecutar:
+
+  rackup -p 4567
+
+=== Usando una Aplicación Clásica con un Archivo config.ru
+
+Escribí el archivo de tu aplicación:
+
+  # app.rb
+  require 'sinatra'
+
+  get '/' do
+    'Hola mundo!'
+  end
+
+Y el <tt>config.ru</tt> correspondiente:
+
+  require 'app'
+  run Sinatra::Application
+
+=== ¿Cuándo Usar config.ru?
+
+Indicadores de que probablemente querés usar <tt>config.ru</tt>:
+
+* Querés realizar el deploy con un hanlder Rack distinto (Passenger, Unicorn,
+  Heroku, ...).
+* Querés usar más de una subclase de <tt>Sinatra::Base</tt>.
+* Querés usar Sinatra únicamente para middleware, pero no como un endpoint.
+
+<b>No hay necesidad de utilizar un archivo <tt>config.ru</tt> exclusivamente
+porque tenés una aplicación modular, y no necesitás una aplicación modular para
+iniciarla con <tt>config.ru</tt>.</b>
+
 === Utilizando Sinatra como Middleware
 
 Sinatra no solo es capaz de usar otro Rack middleware, sino que a su vez,
@@ -1029,7 +1271,7 @@ Pegale una mirada al código: acá está el
 {Sinatra::Delegator mixin}[http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/base.rb#L1128]
 que es {incluido en el espacio de nombres principal}[http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/main.rb#L28].
 
-== Línea de comandos
+== Línea de Comandos
 
 Las aplicaciones Sinatra pueden ser ejecutadas directamente:
 
@@ -1044,33 +1286,71 @@ Las opciones son:
   -s # especifica el servidor/manejador rack (thin es usado por defecto)
   -x # activa el mutex lock (está desactivado por defecto)
 
-== A la vanguardia
+== A la Vanguardia
+
+Si querés usar el código de Sinatra más reciente, sentite libre de ejecutar
+tu aplicación sobre la rama master, en general es bastante estable.
+
+También liberamos prereleases de vez en cuando, así, podés hacer
+
+  gem install sinatra --pre
+
+Para obtener algunas de las últimas características.
 
-Si querés usar el código de Sinatra más reciente, cloná el repositorio
-localmente y ejecutá tu aplicación, asegurándote que el directorio
-<tt>sinatra/lib</tt> esté en el <tt>LOAD_PATH</tt>:
+=== Con Bundler
+
+Esta es la manera recomendada para ejecutar tu aplicación sobre la última
+versión de Sinatra usando {Bundler}[http://gembundler.com/].
+
+Primero, instalá bundler si no lo hiciste todavía:
+
+  gem install bundler
+
+Después, en el directorio de tu proyecto, creá un archivo +Gemfile+:
+
+  source :rubygems
+  gem 'sinatra', :git => "git://github.com/sinatra/sinatra.git"
+
+  # otras dependencias
+  gem 'haml'                    # por ejemplo, si usás haml
+  gem 'activerecord', '~> 3.0'  # quizás también necesités ActiveRecord 3.x
+
+Tené en cuenta que tenés que listar todas las dependencias directas de tu
+aplicación. No es necesario listar las dependencias de Sinatra (Rack y Tilt)
+porque Bundler las agrega directamente.
+
+Ahora podés arrancar tu aplicación así:
+
+  bundle exec ruby miapp.rb
+
+=== Con Git
+
+Cloná el repositorio localmente y ejecutá tu aplicación, asegurándote que el
+directorio <tt>sinatra/lib</tt> esté en el <tt>LOAD_PATH</tt>:
 
   cd miapp
   git clone git://github.com/sinatra/sinatra.git
   ruby -Isinatra/lib miapp.rb
 
-Otra opción consiste en agregar el directorio <tt>sinatra/lib</tt> al
-<tt>LOAD_PATH</tt> dentro de tu aplicación:
+Para actualizar el código fuente de Sinatra en el futuro:
 
-  $LOAD_PATH.unshift File.dirname(__FILE__) + '/sinatra/lib'
-  require 'rubygems'
-  require 'sinatra'
+  cd miapp/sinatra
+  git pull
 
-  get '/acerca-de' do
-    "Estoy usando la versión " + Sinatra::VERSION
-  end
+=== Instalación Global
 
-Para actualizar el código fuente de Sinatra en el futuro:
+Podés construir la gem vos mismo:
 
-  cd miproyecto/sinatra
-  git pull
+  git clone git://github.com/sinatra/sinatra.git
+  cd sinatra
+  rake sinatra.gemspec
+  rake install
+
+Si instalás tus gems como root, el último paso debería ser
+
+  sudo rake install
 
-== Más
+== Lecturas Recomendadas
 
 * {Sito web del proyecto}[http://www.sinatrarb.com/] - Documentación
   adicional, noticias, y enlaces a otros recursos.