sinatra 1.1.2 → 1.1.3

data/AUTHORS

@@ -36,6 +36,15 @@ 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..
+* Zachary Scott for adding Konstantin to the AUTHORS file. He also did help
+  writing the book, but mainly for adding Konstantin.
+* Gabriel Andretta for having people wonder whether our documentation is
+  actually in English or in Spanish.
+* Vasily Polovnyov, Nickolay Schwarz, Luciano Sousa, Wu Jiang, Mickael Riga,
+  Bernhard Essl, Janos Hardi, Kouhei Yanagita and "burningTyger" for willingly
+  translating whatever ends up in the README.
 
 and last but not least:
 

data/CHANGES

@@ -1,3 +1,22 @@
+= 1.1.3 / 2011-02-20
+
+ * 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.

data/README.es.rdoc

@@ -146,7 +146,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
@@ -173,7 +173,7 @@ 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
   require 'haml'
@@ -206,9 +206,9 @@ 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
   require 'erubis'
@@ -217,11 +217,23 @@ La gem/librería erubis es necesaria para renderizar plantillas erubis:
     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
   require 'builder'
@@ -234,7 +246,8 @@ 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
   require 'nokogiri'
@@ -247,7 +260,8 @@ 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
   require 'sass'
@@ -271,7 +285,8 @@ 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
   require 'sass'
@@ -295,7 +310,7 @@ 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
   require 'less'
@@ -308,7 +323,7 @@ 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
   require 'liquid'
@@ -326,7 +341,8 @@ 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
   require "rdiscount"
@@ -343,15 +359,30 @@ 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
+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
 
-La gem/librería RedCloth es necesaria para renderizar plantillas Textile:
+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"
@@ -367,7 +398,7 @@ 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!
@@ -375,7 +406,7 @@ plantillas:
 
 === 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
   require "rdoc"
@@ -391,7 +422,7 @@ 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!
@@ -399,7 +430,7 @@ plantillas:
 
 === 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
   require 'radius'
@@ -417,7 +448,8 @@ 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
   require 'markaby'
@@ -430,8 +462,14 @@ Renderiza <tt>./views/index.mab</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
   require 'coffee-script'
@@ -442,13 +480,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
 
@@ -514,13 +552,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
 
+=== Asociando Extensiones de Archivo
+
+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 mypg(*args) render(:mypg, *args) end
+  end
+
+  get '/' do
+    mypg :index
+  end
+
+Renderiza <tt>./views/index.mypg</tt>. Mirá https://github.com/rtomayko/tilt
+para aprender más de Tilt.
+
 == Ayudantes
 
 Usá el método top-level <tt>helpers</tt> para definir métodos ayudantes que
@@ -683,7 +747,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,
@@ -849,13 +913,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
@@ -872,6 +929,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,
@@ -994,7 +1109,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:
 
@@ -1009,33 +1124,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.