sinatra 1.3.0.c → 1.3.0.d

data/CHANGES

@@ -2,6 +2,14 @@
 
  * Added support for HTTP PATCH requests. (Konstantin Haase)
 
+ * Support for Creole templates, Creole is a standardized wiki markup,
+   supported by many wiki implementations. (Konstanin Haase)
+
+ * The `erubis` method has been deprecated. If Erubis is available, Sinatra
+   will automatically use it for rendering ERB templates. `require 'erb'`
+   explicitly to prevent that behavior. (Magnus Holm, Ryan Tomayko, Konstantin
+   Haase)
+
  * Set up `Rack::Logger` or `Rack::NullLogger` depending on whether logging
    was enabled or not. Also, expose that logger with the `logger` helper
    method. (Konstantin Haase)
@@ -18,6 +26,30 @@
  * Added `request.accept?` and `request.preferred_type` to ease dealing with
    `Accept` headers. (Konstantin Haase)
 
+= 1.2.4 / 2011-04-30
+
+ * Sinatra::Application (classic style) does not use a session secret in
+   development mode, so sessions are not invalidated after every request when
+   using Shotgun. (Konstantin Haase)
+
+ * The request object was shared between multiple Sinatra instances in the
+   same middleware chain. This caused issues if any non-sinatra routing
+   happend in-between two of those instances, or running a request twice
+   against an application (described in the README). The caching was reverted.
+   See GH#239 and GH#256 for more infos. (Konstantin Haase)
+
+ * Fixes issues where the top level DSL was interfering with method_missing
+   proxies. This issue surfaced when Rails 3 was used with older Sass versions
+   and Sinatra >= 1.2.0. (Konstantin Haase)
+
+ * Sinatra::Delegator.delegate is now able to delegate any method names, even
+   those containing special characters. This allows better integration into
+   other programming languages on Rubinius (probably on the JVM, too), like
+   Fancy. (Konstantin Haase)
+
+ * Remove HEAD request logic and let Rack::Head handle it instead. (Paolo
+   "Nusco" Perrotta)
+
 = 1.2.3 / 2011-04-13
 
  * This release is compatible with Tilt 1.3, it will still work with Tilt 1.2.2,

data/Gemfile

@@ -17,7 +17,7 @@ gem 'rack-test', '>= 0.5.6'
 
 # Allows stuff like `tilt=1.2.2 bundle install` or `tilt=master ...`.
 # Used by the CI.
-tilt = ENV['tilt'].dup || 'stable'
+tilt = (ENV['tilt'] || 'stable').dup
 tilt.sub! 'tilt-', ''
 if tilt != 'stable'
   tilt = {:git => TILT_REPO, :branch => tilt} unless tilt =~ /(\d+\.)+\d+/
@@ -25,6 +25,7 @@ if tilt != 'stable'
 end
 
 gem 'haml', '>= 3.0', :group => 'haml'
+gem 'sass', :group => 'sass'
 gem 'builder', :group => 'builder'
 gem 'erubis', :group => 'erubis'
 gem 'less', :group => 'less'
@@ -34,9 +35,14 @@ gem 'slim', :group => 'slim'
 gem 'RedCloth', :group => 'redcloth'
 gem 'coffee-script', '>= 2.0', :group => 'coffee-script'
 gem 'rdoc', :group => 'rdoc'
+gem 'kramdown', :group => 'kramdown'
+gem 'maruku', :group => 'maruku'
+gem 'creole', :group => 'creole'
 
 platforms :ruby do
   gem 'rdiscount', :group => 'rdiscount'
+  ## bluecloth is broken
+  #gem 'bluecloth', :group => 'bluecloth'
 end
 
 platforms :ruby_18, :jruby do

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2007, 2008, 2009, 2010 Blake Mizerany
+Copyright (c) 2007, 2008, 2009, 2010, 2011 Blake Mizerany
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/README.de.rdoc

@@ -22,7 +22,6 @@ Die Seite kann nun unter http://localhost:4567 betrachtet werden.
 Es wird empfohlen, den Thin-Server via <tt>gem install thin</tt> zu 
 installieren, den Sinatra dann, soweit vorhanden, automatisch verwendet.
 
-
 == Routen
 
 In Sinatra wird eine Route durch eine HTTP-Methode und ein URL-Muster
@@ -91,7 +90,6 @@ Und auch hier können Block-Parameter genutzt werden:
     "Hallo, #{c}!"
   end
 
-
 === Bedingungen
 
 An Routen können eine Vielzahl von Bedingungen angehängt werden, die erfüllt
@@ -132,7 +130,6 @@ Es können auch andere Bedingungen relativ einfach hinzugefügt werden:
     "Tut mir leid, verloren."
   end
 
-
 === Rückgabewerte
 
 Durch den Rückgabewert eines Routen-Blocks wird mindestens der Response-Body
@@ -162,7 +159,6 @@ Damit lässt sich relativ einfach Streaming implementieren:
 
     get('/') { Stream.new }
 
-
 === Eigene Routen-Muster 
 
 Wie oben schon beschrieben, ist Sinatra von Haus aus mit Unterstützung für 
@@ -205,7 +201,6 @@ Oder unter Verwendung eines negativen look ahead:
     # ...
   end
 
-
 == Statische Dateien
 
 Statische Dateien werden aus dem <tt>./public</tt>-Ordner ausgeliefert. Es ist
@@ -218,7 +213,6 @@ Zu beachten ist, dass der Ordnername public nicht Teil der URL ist. Die Datei
 <tt>./public/css/style.css</tt> ist unter
 <tt>http://example.com/css/style.css</tt> zu finden.
 
-
 == Views/Templates
 
 Standardmäßig wird davon ausgegangen, dass sich Templates im
@@ -232,7 +226,6 @@ mit Symbols auf Templates verweisen sollte, auch wenn sich ein Template in
 einem Unterordner befindet (in diesen Fall <tt>:'subdir/template'</tt>).
 Rendering-Methoden rendern jeden String direkt.
 
-
 === Haml-Templates
 
 Das +haml+-Gem wird benötigt, um Haml-Templates rendern zu können:
@@ -257,7 +250,6 @@ und individuell überschrieben werden.
     haml :index, :format => :html4 # überschrieben
   end
 
-
 === Erb-Templates
 
   # erb muss eingebunden werden
@@ -269,7 +261,6 @@ und individuell überschrieben werden.
 
 Dieser Code rendert <tt>./views/index.erb</tt>.
 
-
 === Erubis
 
 Das +erubis+-Gem wird benötigt, um Erubis-Templates rendern zu können:
@@ -294,7 +285,6 @@ Es ist auch möglich, Erb durch Erubis zu ersetzen:
 
 Dieser Code rendert ebenfalls <tt>./views/index.erb</tt>.
 
-
 === Builder-Templates
 
 Das +builder+-Gem wird benötigt, um Builder-Templates rendern zu können:
@@ -308,7 +298,6 @@ Das +builder+-Gem wird benötigt, um Builder-Templates rendern zu können:
 
 Dieser Code rendert <tt>./views/index.builder</tt>.
 
-
 === Nokogiri-Templates
 
 Das +nokogiri+-Gem wird benötigt, um Nokogiri-Templates rendern zu können:
@@ -322,7 +311,6 @@ Das +nokogiri+-Gem wird benötigt, um Nokogiri-Templates rendern zu können:
 
 Dieser Code rendert <tt>./views/index.nokogiri</tt>.
 
-
 === Sass-Templates
 
 Das +haml+- oder +sass+-Gem wird benötigt, um Sass-Templates rendern zu können:
@@ -347,7 +335,6 @@ und individuell überschrieben werden.
     sass :stylesheet, :style => :expanded # überschrieben
   end
 
-
 === SCSS-Templates
 
 Das +haml+- oder +sass+-Gem wird benötigt, um SCSS-Templates rendern zu können:
@@ -372,7 +359,6 @@ individuell überschrieben werden.
     scss :stylesheet, :style => :expanded # überschrieben
   end
 
-
 === Less-Templates
 
 Das +less+-Gem wird benötigt, um Less-Templates rendern zu können:
@@ -386,7 +372,6 @@ Das +less+-Gem wird benötigt, um Less-Templates rendern zu können:
 
 Dieser Code rendert <tt>./views/stylesheet.less</tt>.
 
-
 === Liquid-Templates
 
 Das +liquid+-Gem wird benötigt, um Liquid-Templates rendern zu können:
@@ -405,7 +390,6 @@ aufgerufen werden können, ist es möglich, +locals+ zu übergeben:
 
   liquid :index, :locals => { :key => 'value' }
 
-
 === Markdown-Templates
 
 Das +rdiscount+-Gem wird benötigt, um Markdown-Templates rendern zu können:
@@ -469,7 +453,6 @@ Ebenso ist es möglich, Markdown mit BlueCloth anstelle von RDiscount zu parsen:
 
 Das sollte <tt>./views/index.md</tt> mit BlueCloth rendern.
 
-
 === Textile-Templates
 
 Das +redcloth+-Gem wird benötigt, um Textile-Templates rendern zu können:
@@ -518,7 +501,6 @@ Denk daran, dass solche Einstellungen auch global gesetzt werden können:
 Das wird <tt>./views/index.textile</tt> (und jedes andere Markdown-Template)
 mit <tt>./views/post.haml</tt> als Layout rendern.
 
-
 === RDoc-Templates
 
 Das +rdoc+-Gem wird benötigt, um RDoc-Templates rendern zu können:
@@ -566,7 +548,6 @@ Denk daran, dass solche Einstellungen auch global gesetzt werden können:
 Das wird <tt>./views/index.rdoc</tt> (und jedes andere Markdown-Template) mit
 <tt>./views/post.haml</tt> als Layout rendern.
 
-
 === Radius-Templates
 
 Das +radius+-Gem wird benötigt, um Radius-Templates rendern zu können:
@@ -585,7 +566,6 @@ aufgerufen werden können, es es möglich, +locals+ zu übergeben:
 
   radius :index, :locals => { :key => 'value' }
 
-
 === Markaby-Templates
 
 Das +markaby+-Gem wird benötigt, um Markaby-Templates rendern zu können:
@@ -599,7 +579,6 @@ Das +markaby+-Gem wird benötigt, um Markaby-Templates rendern zu können:
 
 Dieser Code rendert <tt>./views/index.mab</tt>.
 
-
 === Slim-Templates
 
 Das +slim+-Gem wird benötigt, um Slim-Templates rendern zu können:
@@ -613,6 +592,18 @@ Das +slim+-Gem wird benötigt, um Slim-Templates rendern zu können:
 
 Dieser Code rendert <tt>./views/index.slim</tt>.
 
+=== Creole-Templates
+
+Das +creole+-Gem wird benötigt, um Creole-Templates rendern zu können:
+
+  # creole muss eingebunden werden
+  require 'creole'
+
+  get '/' do
+    creole :index
+  end
+
+Dieser Code rendert <tt>./views/index.creole</tt>.
 
 === CoffeeScript-Templates
 
@@ -637,7 +628,6 @@ Nun können CoffeeScript-Templates in der Applikation gerendert werden:
 
 Dieser Code rendert <tt>./views/application.coffee</tt>.
 
-
 === Inline-Templates
 
   get '/' do
@@ -646,7 +636,6 @@ Dieser Code rendert <tt>./views/application.coffee</tt>.
 
 Rendert den Inline-Template-String.
 
-
 === Auf Variablen in Templates zugreifen
 
 Templates werden in demselben Kontext ausgeführt wie Routen. Instanzvariablen 
@@ -667,7 +656,6 @@ Oder durch einen expliziten Hash von lokalen Variablen:
 Dies wird typischerweise bei Verwendung von Subtemplates (partials) in anderen
 Templates eingesetzt.
 
-
 === Inline-Templates
 
 Templates können auch am Ende der Datei definiert werden:
@@ -692,7 +680,6 @@ Anmerkung: Inline-Templates, die in der Datei definiert sind, die <tt>require
 in anderen Dateien aufzurufen, muss explizit <tt>enable :inline_templates</tt> 
 verwendet werden.
 
-
 === Benannte Templates
 
 Templates können auch mit der Top-Level <tt>template</tt>-Methode definiert
@@ -718,7 +705,6 @@ werden:
     haml :index, :layout => !request.xhr?
   end
 
-
 === Dateiendungen zuordnen
 
 Um eine Dateiendung einer Template-Engine zuzuordnen, kann 
@@ -728,7 +714,6 @@ bewerkstelligen:
 
   Tilt.register :tt, Tilt[:textile]
 
-
 === Eine eigene Template-Engine hinzufügen
 
 Zu allererst muss die Engine bei Tilt registriert und danach eine 
@@ -748,7 +733,6 @@ Dieser Code rendert <tt>./views/application.mtt</tt>. Siehe
 github.com/rtomayko/tilt[https://github.com/rtomayko/tilt], um mehr über Tilt 
 zu lernen.
 
-
 == Filter
 
 Before-Filter werden vor jedem Request in demselben Kontext, wie danach die 
@@ -796,7 +780,6 @@ werden:
     # ...
   end
 
-
 == Helfer
 
 Durch die Top-Level <tt>helpers</tt>-Methode werden sogenannte Helfer-Methoden
@@ -812,7 +795,6 @@ definiert, die in Routen und Templates verwendet werden können:
     bar(params[:name])
   end
 
-
 === Sessions verwenden
 Sessions werden verwendet, um Zustände zwischen den Requests zu speichern.
 Sind sie aktiviert, kann ein Session-Hash je Benutzer-Session verwendet werden.
@@ -856,7 +838,6 @@ Einstellungen ablegen.
 
   set :sessions, :domain => 'foo.com'
 
-
 == Anhalten
 
 Zum sofortigen Stoppen eines Request in einem Filter oder einer Route:
@@ -883,7 +864,6 @@ Natürlich ist es auch möglich, ein Template mit +halt+ zu verwenden:
 
   halt erb(:error)
 
-
 == Weiterspringen
 
 Eine Route kann mittels <tt>pass</tt> zu der nächsten passenden Route springen:
@@ -901,15 +881,14 @@ Der Block wird sofort verlassen und es wird nach der nächsten treffenden Route
 gesucht. Ein 404-Fehler wird zurückgegeben, wenn kein treffendes Routen-Muster
 gefunden wird.
 
-
 === Eine andere Route ansteuern
 
 Manchmal entspricht +pass+ nicht den Anforderungen, wenn das Ergebnis einer
 anderen Route gefordert wird. Um das zu erreichen, lässt sich +call+ nutzen:
 
   get '/foo' do
-    status, headers, body = call request.env.merge("PATH_INFO" => '/bar')
-    [status, body.upcase]
+    status, headers, body = call env.merge("PATH_INFO" => '/bar')
+    [status, headers, body.map(&:upcase)]
   end
 
   get '/bar' do
@@ -926,7 +905,6 @@ Kopie der Instanz erzeugt werden soll, kann <tt>call!</tt> anstelle von
 
 Die Rack-Spezifikationen enthalten weitere Informationen zu +call+.
 
-
 === Body, Status-Code und Header setzen
 
 Es ist möglich und empfohlen, den Status-Code sowie den Response-Body mit einem
@@ -974,7 +952,6 @@ Der Logger übernimmt dabei automatisch alle im Rack-Handler eingestellten Log-
 Vorgaben. Ist Loggen ausgeschaltet, gibt die Methode ein Leerobjekt zurück.
 In den Routen und Filtern muss man sich also nicht weiter darum kümmern.
 
-
 Beachte, dass das Loggen standardmäßig nur für <tt>Sinatra::Application</tt>
 voreingestellt ist. Wird über <tt>Sinatra::Base</tt> vererbt, muss es erst
 aktiviert werden:
@@ -985,7 +962,6 @@ aktiviert werden:
     end
   end
 
-
 == Mime-Types
 
 Wenn <tt>send_file</tt> oder statische Dateien verwendet werden, kann es
@@ -1001,7 +977,6 @@ Es kann aber auch der +content_type+-Helfer verwendet werden:
     "foo foo foo"
   end
 
-
 === URLs generieren
 
 Zum Generieren von URLs sollte die +url+-Helfer-Methode genutzen werden, so 
@@ -1014,7 +989,6 @@ Soweit vorhanden, wird Rücksicht auf Proxys und Rack-Router genommen.
 Diese Methode ist ebenso über das Alias +to+ zu erreichen (siehe Beispiel
 unten).
 
-
 === Browser-Umleitung
 
 Eine Browser-Umleitung kann mithilfe der +redirect+-Helfer-Methode erreicht
@@ -1060,6 +1034,63 @@ oder eine Session verwendet werden:
   end
 
 
+=== Cache einsetzen
+
+Ein sinnvolles Einstellen von Header-Daten ist die Grundlage für ein
+ordentliches HTTP-Caching.
+
+Der Cache-Control-Header lässt sich ganz einfach einstellen:
+
+  get '/' do
+    cache_control :public
+    "schon gecached!"
+  end
+
+Profitipp: Caching im before-Filter aktivieren
+
+  before do
+    cache_control :public, :must_revalidate, :max_age => 60
+  end
+
+Bei Verwendung der +expires+-Helfermethode zum Setzen des gleichnamigen
+Headers, wird <tt>Cache-Control</tt> automatisch eigestellt:
+
+  before do
+    expires 500, :public, :must_revalidate
+  end
+
+Um alles richtig zu machen, sollten auch +etag+ und +last_modified+ verwendet
+werden. Es wird empfohlen, dass diese Helfer aufgerufen werden *bevor* die
+eigentliche Arbeit anfängt, da sie sofort eine Antwort senden, wenn der
+Client eine aktuelle Version im Cache vorhält:
+
+  get '/article/:id' do
+    @article = Article.find params[:id]
+    last_modified @article.updated_at
+    etag @article.sha1
+    erb :article
+  end
+
+ebenso ist es möglich einen
+{schwachen ETag}[http://de.wikipedia.org/wiki/HTTP_ETag] zu verwenden:
+
+  etag @article.sha1, :weak
+
+Diese Helfer führen nicht das eigentliche Caching aus, sondern geben die dafür
+notwendigen Informationen an den Cache weiter. Für schnelle Cache-Lösungen
+bietet sich z.B. {rack-cache}[http://rtomayko.github.com/rack-cache/] an:
+
+  require "rack/cache"
+  require "sinatra"
+  
+  use Rack::Cache
+  
+  get '/' do
+    cache_control :public, :max_age => 36000
+    sleep 5
+    "hello"
+  end
+
 === Dateien versenden
 
 Zum Versenden von Dateien kann die <tt>send_file</tt>-Helfer-Methode verwendet
@@ -1095,7 +1126,6 @@ Ruby-Prozess auch andere Möglichkeiten genutzt. Bei Verwendung der
 <tt>send_file</tt>-Helfer-Methode kümmert sich Sinatra selbstständig um die
 Range-Requests.
 
-
 == Das Request-Objekt
 
 Auf das +request+-Objekt der eigehenden Anfrage kann vom Anfrage-Scope aus
@@ -1149,7 +1179,6 @@ Der <tt>request.body</tt> ist ein IO- oder StringIO-Objekt:
     "Hallo #{daten['name']}!"
   end
 
-
 === Anhänge
 
 Damit der Browser erkennt, dass ein Response gespeichert und nicht im Browser
@@ -1167,7 +1196,6 @@ Ebenso kann eine Dateiname als Parameter hinzugefügt werden:
     "Speichern!"
   end
 
-
 === Nachschlagen von Template-Dateien
 
 Die <tt>find_template</tt>-Helfer-Methode wird genutzt, um Template-Dateien zum
@@ -1213,7 +1241,6 @@ Template-Pfade samt Inhalt gecached, solange nicht im Entwicklungsmodus
 gearbeitet wird. Das sollte im Hinterkopf behalten werden, wenn irgendwelche
 verrückten Methoden zusammenbastelt werden.
 
-
 == Konfiguration
 
 Wird einmal beim Starten in jedweder Umgebung ausgeführt:
@@ -1261,7 +1288,6 @@ Diese Einstellungen sind über +settings+ erreichbar:
     ...
   end
 
-
 === Mögliche Einstellungen
 
 [absolute_redirects]  Wenn ausgeschaltet, wird Sinatra relative Redirects
@@ -1357,14 +1383,12 @@ Diese Einstellungen sind über +settings+ erreichbar:
 
 [views]               Verzeichnis der Views.
 
-
 == Fehlerbehandlung
 
 Error-Handler laufen in demselben Kontext wie Routen und Filter, was bedeutet,
 dass alle Goodies wie <tt>haml</tt>, <tt>erb</tt>, <tt>halt</tt>, etc.
 verwendet werden können.
 
-
 === Nicht gefunden
 
 Wenn eine <tt>Sinatra::NotFound</tt>-Exception geworfen wird oder der
@@ -1374,7 +1398,6 @@ Statuscode 404 ist, wird der <tt>not_found</tt>-Handler ausgeführt:
     'Seite kann nirgendwo gefunden werden.'
   end
 
-
 === Fehler
 
 Der +error+-Handler wird immer ausgeführt, wenn eine Exception in einem
@@ -1388,7 +1411,7 @@ Routen-Block oder in einem Filter geworfen wurde. Die Exception kann über die
 Benutzerdefinierte Fehler:
 
   error MeinFehler do
-    'Au weia, ' + request.env['sinatra.error'].message
+    'Au weia, ' + env['sinatra.error'].message
   end
 
 Dann, wenn das passiert:
@@ -1420,7 +1443,6 @@ Oder ein Status-Code-Bereich:
 Sinatra setzt verschiedene <tt>not_found</tt>- und <tt>error</tt>-Handler in
 der Development-Umgebung.
 
-
 == Rack-Middleware
 
 Sinatra baut auf Rack[http://rack.rubyforge.org/], einem minimalistischen
@@ -1456,7 +1478,6 @@ URL-Routing, Authentifizierung und Session-Verarbeitung. Sinatra verwendet
 viele von diesen Komponenten automatisch, abhängig von der Konfiguration. So 
 muss +use+ häufig nicht explizit verwendet werden.
 
-
 == Testen
 
 Sinatra-Tests können mit jedem auf Rack aufbauendem Test-Framework geschrieben
@@ -1492,7 +1513,6 @@ werden. {Rack::Test}[http://gitrdoc.com/brynary/rack-test] wird empfohlen:
 Anmerkung: Das eingebaute Sinatra::Test-Modul und die 
 Sinatra::TestHarness-Klasse werden seit Version 0.9.2 nicht mehr unterstützt.
 
-
 == Sinatra::Base - Middleware, Bibliotheken und modulare Anwendungen
 
 Das Definieren einer Top-Level-Anwendung funktioniert gut für 
@@ -1538,7 +1558,6 @@ per Standard deaktiviert. Das betrifft auch den eingebauten Server. Siehe
 {Optionen und Konfiguration}[http://sinatra.github.com/configuration.html] für
 Details über mögliche Optionen.
 
-
 === Modularer vs. klassischer Stil
 
 Entgegen häufiger Meinungen gibt es nichts gegen den klassischen Stil
@@ -1568,7 +1587,6 @@ Unterschiede beachtet werden:
   method_override     true                    false
   inline_templates    true                    false
 
-
 === Eine modulare Applikation bereitstellen
 
 Es gibt zwei übliche Wege, eine modulare Anwendung zu starten. Zum einen über
@@ -1599,7 +1617,6 @@ Starte:
 
   rackup -p 4567
 
-
 === Eine klassische Anwendung mit einer config.ru verwenden
 
 Schreibe eine Anwendungsdatei:
@@ -1616,7 +1633,6 @@ sowie eine dazugehörige <tt>config.ru</tt>-Datei:
   require 'app'
   run Sinatra::Application
 
-
 === Wann sollte eine config.ru-Datei verwendet werden?
 
 Anzeichen dafür, dass eine <tt>config.ru</tt>-Datei gebraucht wird:
@@ -1631,7 +1647,6 @@ eine Anwendung im modularen Stil betrieben werden soll. Ebenso wird keine
 Anwendung mit modularem Stil benötigt, um eine <tt>config.ru</tt>-Datei zu 
 verwenden.</b>
 
-
 === Sinatra als Middleware nutzen
 
 Es ist nicht nur möglich, andere Rack-Middleware mit Sinatra zu nutzen, es kann
@@ -1679,7 +1694,6 @@ ohne dass sie einer Konstanten zugeordnet werden. Dies lässt sich mit
   my_app = Sinatra.new { get('/') { "hallo" } }
   my_app.run!
 
-
 Die Applikation kann mit Hilfe eines optionalen Parameters erstellt werden:
 
   require 'sinatra/base'
@@ -1710,13 +1724,11 @@ Ebenso lassen sich damit hervorragend Sinatra-Middlewares erstellen:
 
   run RailsProject::Application
 
-
 == Geltungsbereich und Bindung
 
 Der Geltungsbereich (Scope) legt fest, welche Methoden und Variablen zur
 Verfügung stehen.
 
-
 === Anwendungs- oder Klassen-Scope
 
 Jede Sinatra-Anwendung entspricht einer Sinatra::Base-Subklasse. Falls die Top-
@@ -1752,7 +1764,6 @@ Auf das Scope-Objekt (die Klasse) kann wie folgt zugegriffen werden:
   { |c| ... }</tt>).
 * +settings+ aus den anderen Scopes heraus.
 
-
 === Anfrage- oder Instanz-Scope
 
 Für jede eingehende Anfrage wird eine neue Instanz der Anwendungs-Klasse
@@ -1783,7 +1794,6 @@ Im Anfrage-Scope befindet man sich:
 * In Helfer-Methoden
 * In Templates
 
-
 === Delegation-Scope
 
 Vom Delegation-Scope aus werden Methoden einfach an den Klassen-Scope
@@ -1805,7 +1815,6 @@ Schau am besten im Code nach: Hier ist
 definiert und wird in den
 {globalen Namespace eingebunden}[http://github.com/sinatra/sinatra/blob/master/lib/sinatra/main.rb#L25].
 
-
 == Kommandozeile
 
 Sinatra-Anwendungen können direkt von der Kommandozeile aus gestartet werden:
@@ -1821,7 +1830,6 @@ Die Optionen sind:
   -s # Rack-Server/Handler setzen (Standard ist thin)
   -x # Mutex-Lock einschalten (Standard ist off)
 
-
 == Systemanforderungen
 
 Die folgenden Versionen werden offiziell unterstützt:
@@ -1871,22 +1879,21 @@ Zeit für nichts garantiert werden. Es kann aber erwartet werden, dass Ruby
 Sinatra sollte auf jedem Betriebssystem laufen, dass den gewählten Ruby-
 Interpreter unterstützt.
 
-
 == Der neueste Stand (The Bleeding Edge)
+
 Um auf dem neusten Stand zu bleiben, kann der Master-Branch verwendet werden.
 Er sollte recht stabil sein. Ebenso gibt es von Zeit zu Zeit prerelease Gems, 
 die so installiert werden:
   
   gem install sinatra --pre
 
-
 === Mit Bundler
 
 Wenn die Applikation mit der neuesten Version von Sinatra und
-{Bundler}[http://gembundler.com/] genutzt werden soll, schlagen wir folgenden
-Weg vor:
+{Bundler}[http://gembundler.com/] genutzt werden soll, empfehlen wir den
+nachfolgenden Weg.
 
-Soweit Bundler noch nicht installiert ist, folgendes:
+Soweit Bundler noch nicht installiert ist:
 
   gem install bundler
 
@@ -1934,7 +1941,6 @@ Um Sinatra-Code von Zeit zu Zeit zu aktualisieren:
   cd myproject/sinatra
   git pull
 
-
 === Gem erstellen
 
 Aus der eigenen lokalen Kopie kann nun auch ein globales Gem gebaut werden:
@@ -1949,21 +1955,23 @@ folgendermaßen lauten:
 
   sudo rake install
 
-
 == Versions-Verfahren
 
 Sinatra folgt dem sogenannten {Semantic Versioning}[http://semver.org/], d.h. 
 SemVer und SemVerTag.
 
-
 == Mehr
 
 * {Projekt-Website}[http://sinatra.github.com/] - Ergänzende Dokumentation,
   News und Links zu anderen Ressourcen.
 * {Hilfe beisteuern}[http://sinatra.github.com/contributing.html] - Einen
-Fehler gefunden? Brauchst du Hilfe? Hast du einen Patch?
+  Fehler gefunden? Brauchst du Hilfe? Hast du einen Patch?
 * {Issue-Tracker}[http://github.com/sinatra/sinatra/issues]
 * {Twitter}[http://twitter.com/sinatra]
 * {Mailing-Liste}[http://groups.google.com/group/sinatrarb]
 * {IRC: #sinatra}[irc://chat.freenode.net/#sinatra] auf http://freenode.net
 
+* API Dokumentation für die {aktuelle Version}[http://rubydoc.info/gems/sinatra]
+  oder für {HEAD}[http://rubydoc.info/github/sinatra/sinatra] auf
+  http://rubydoc.info
+