sinatra 1.3.0.e → 1.3.0.f

data/README.fr.rdoc

@@ -1,12 +1,13 @@
-= Sinatra
+= Sinatra
 <i>Attention : Ce document correspond à la traduction de la version anglaise et
 il n'est peut être plus à jour.</i>
 
-Sinatra est un DSL pour créer rapidement des applications web en Ruby et sans
-effort :
+Sinatra est un DSL pour créer rapidement et facilement des applications web en
+Ruby :
 
   # mon_application.rb
   require 'sinatra'
+
   get '/' do
     'Bonjour le monde !'
   end
@@ -18,14 +19,13 @@ Installez la gem et lancez avec :
 
 Le résultat est visible sur : http://localhost:4567
 
-Il est également recommandé d'exécuter <tt>gem install thin</tt>, que Sinatra
-utilisera si disponible.
+Il est recommandé d'exécuter également <tt>gem install thin</tt>, pour que
+Sinatra utilise le server Thin quand il est disponible.
 
 == Routes
 
 Dans Sinatra, une route est une méthode HTTP couplée à un masque (pattern)
-URL.
-Chaque route est associée à un bloc :
+URL. Chaque route est associée à un bloc :
 
   get '/' do
     .. montrer quelque chose ..
@@ -51,8 +51,8 @@ Chaque route est associée à un bloc :
     .. apaiser quelquechose ..
   end
 
-Les routes sont comparées dans l'ordre où elles ont été définies. La première
-route qui correspond à la requête est invoquée.
+Les routes sont évaluées  dans l'ordre où elles ont été définies. La première
+route qui correspond à la requête est appelée.
 
 Les masques peuvent inclure des paramètres nommés, accessibles par
 l'intermédiaire du hash <tt>params</tt> :
@@ -63,38 +63,50 @@ l'intermédiaire du hash <tt>params</tt> :
     "Bonjour #{params[:nom]} !"
   end
 
-Vous pouvez aussi les nommer directement dans les paramètres du bloc comme
-ceci :
+Vous pouvez aussi accéder aux paramètres nommés directement grâce aux
+paramètres du bloc comme ceci :
 
   get '/bonjour/:nom' do |n|
     "Bonjour #{n} !"
   end
 
 Une route peut contenir un splat (caractère joker), accessible par
-l'intermédiaire de la liste <tt>params[:splat]</tt> :
+l'intermédiaire du tableau <tt>params[:splat]</tt> :
 
   get '/dire/*/a/*' do
-    # répondrait à /dire/bonjour/a/monde
+    # répond à /dire/bonjour/a/monde
     params[:splat] # => ["bonjour", "monde"]
   end
 
   get '/telecharger/*.*' do
-    # répondrait à /telecharger/chemin/vers/fichier.xml
+    # répond à /telecharger/chemin/vers/fichier.xml
     params[:splat] # => ["chemin/vers/fichier", "xml"]
   end
 
-Une route peut s'exprimer avec une Expression Régulière :
+Ou par l'intermédiaire des paramètres du bloc :
+
+  get '/telecharger/*.*' do |chemin, ext|
+    [chemin, ext] # => ["path/to/file", "xml"]
+  end
+
+Une route peut aussi être définie par une Expression Régulière :
 
   get %r{/bonjour/([\w]+)} do
     "Bonjour, #{params[:captures].first} !"
   end
 
-Là aussi on peut utiliser les paramètres de bloc :
+Là encore on peut utiliser les paramètres de bloc :
 
   get %r{/bonjour/([\w]+)} do |c|
     "Bonjour, #{c} !"
   end
 
+Les routes peuvent aussi comporter des paramètres optionnels :
+
+  get '/posts.?:format?' do
+    # répond à "GET /posts" et aussi à "GET /posts.json", "GET /posts.xml" etc...
+  end
+
 === Conditions
 
 Les routes peuvent définir toutes sortes de conditions, comme par exemple le
@@ -134,26 +146,45 @@ Vous pouvez facilement définir vos propres conditions :
     "Désolé, vous avez perdu."
   end
 
+Utilisez un splat (caractère joker) dans le cas d'une condition qui prend
+plusieurs valeurs :
+
+  set(:auth) do |*roles|   # <- ici on utilise un splat
+    condition do
+      unless logged_in? && roles.any? {|role| current_user.in_role? role }
+        redirect "/login/", 303 
+      end
+    end
+  end
+
+  get "/mon/compte/", :auth => [:user, :admin] do
+    "Informations sur votre compte"
+  end
+
+  get "/reserve/aux/admins/", :auth => :admin do  
+    "Seuls les administrateurs sont acceptés ici !"
+  end
+
 === Valeurs de retour
 
-La valeur de retour d'un bloc définissant une route détermine le corps de la
-réponse qui sera transmise au client HTTP ou du moins au prochain middleware
-dans la pile Rack. Le plus généralement, il s'agit d'une chaîne de caractères,
+La valeur renvoyée par le bloc correspondant à une route constitue le corps de
+la réponse qui sera transmise au client HTTP ou du moins au prochain middleware
+dans la pile Rack. Le plus souvent, il s'agit d'une chaîne de caractères,
 comme dans les exemples précédents. Cependant, d'autres valeurs sont
 acceptées.
 
-Vous pouvez renvoyer n'importe quel objet qui soit une réponse Rack valide, un
-corps de réponse Rack ou un code retour HTTP :
+Vous pouvez renvoyer n'importe quel objet qu'il s'agisse d'une réponse Rack
+valide, d'un corps de réponse Rack ou d'un code statut HTTP :
 
-* Un tableau de 3 éléments : <tt>[code retour (Fixnum), entêtes (Hash), corps
-  de réponse (répondant à #each)]</tt>
-* Un tableau de 2 élements : <tt>[code retour (Fixnum), corps de réponse
+* Un tableau de 3 éléments : <tt>[code statut (Fixnum), entêtes (Hash), corps
+  de la réponse (répondant à #each)]</tt>
+* Un tableau de 2 élements : <tt>[code statut (Fixnum), corps de la réponse
   (répondant à #each)]</tt>
 * Un objet qui répond à <tt>#each</tt> et qui ne transmet que des chaînes de
   caractères au bloc fourni
-* Un Fixnum représentant le code retour
+* Un Fixnum représentant le code statut
 
-Ainsi, on peut facilement implémenter un streaming par exemple :
+Avec cela, on peut facilement implémenter un streaming par exemple :
 
     class Stream
       def each
@@ -163,11 +194,15 @@ Ainsi, on peut facilement implémenter un streaming par exemple :
 
     get('/') { Stream.new }
 
+Vous pouvez aussi utiliser le helper +stream+ (présenté un peu plus loin) pour
+éviter la surcharge et intégrer le traitement relatif au streaming dans le bloc
+de code de la route.
+
 === Masques de route spécifiques
 
-Comme montré plus haut, Sinatra embarque le support pour l'utilisation de
-masques utilisant des chaînes de caractères ou des expressions régulières
-pour définir les routes. Toutefois, cela ne s'arrête pas là. Vous pouvez
+Comme cela a été vu auparavant, Sinatra offre la possibilité d'utiliser des
+masques sous forme de chaines de caractères ou des expressions régulières
+pour définir les routes. Mais il est possible de faire bien plus. Vous pouvez
 facilement définir vos propres masques :
 
   class MasqueToutSauf
@@ -191,7 +226,7 @@ facilement définir vos propres masques :
     # ...
   end
 
-Notez que l'exemple ci-dessus est bien trop compliqué et le même résultat
+Notez que l'exemple ci-dessus est bien trop compliqué et que le même résultat
 peut être obtenu avec :
 
   get // do
@@ -207,45 +242,49 @@ Ou bien en utilisant la forme négative :
 
 == Fichiers statiques
 
-Par défaut, le dossier <tt>./public</tt> est utilisé pour servir les fichiers
-statiques. Vous pouvez changer ce dossier pour un autre nom grâce au paramètre
-<tt>:public</tt> :
+Les fichiers du dossier <tt>./public</tt> sont servis de façon statique. Vous
+avez la possibilité d'utiliser un autre répertoire en définissant le paramètre
+<tt>:public_folder</tt> :
 
-  set :public, File.dirname(__FILE__) + '/statique'
+  set :public_folder, File.dirname(__FILE__) + '/statique'
 
-Notez que le nom du dossier public n'est pas inclus dans l'URL. Un fichier
-sous <tt>./public/css/style.css</tt> est appelé avec l'URL : <tt>http://exemple.com/css/style.css</tt>.
+Notez que le nom du dossier public n'apparait pas dans l'URL. Le fichier
+<tt>./public/css/style.css</tt> sera appelé via l'URL : 
+<tt>http://exemple.com/css/style.css</tt>.
+
+Utilisez le paramètre <tt>:static_cache_control</tt> pour ajouter l'information
+d'en-tête <tt>Cache-Control</tt> (voir plus loin).
 
 == Vues / Templates
 
-Chaque langage de template est exposé via sa propre méthode de rendu.
-Ces méthodes retournent tout simplement une chaîne de caractères.
+Chaqie langage de template est disponible via sa propre méthode de rendu,
+lesquelles renvoient tout simplement une chaîne de caractères.
 
   get '/' do
     erb :index
   end
 
-Ceci effectue le rendu de <tt>views/index.erb</tt>.
+Ceci effectue le rendu de la vue <tt>views/index.erb</tt>.
 
-Plutôt que le nom d'un template, vous pouvez directement passer le contenu du
-template :
+Plutôt que d'utiliser le nom d'un template, vous pouvez directement passer
+le contenu du template :
 
   get '/' do
     code = "<%= Time.now %>"
     erb code
   end
 
-Les templates prennent un second paramètre, un hash d'options :
+Les méthodes de templates acceptent un second paramètre, un hash d'options :
 
   get '/' do
     erb :index, :layout => :post
   end
 
-Cecie effectue le rendu de <tt>views/index.erb</tt> embarqué dans
-<tt>views/post.erb</tt> (<tt>views/layout.erb</tt> est la valeur par défaut
-si ce fichier existe).
+Ceci effectuera le rendu de la vue <tt>views/index.erb</tt> en l'intégrant
+au +layout+ <tt>views/post.erb</tt> (les vues Erb sont intégrées par défaut
+au +layout+ <tt>views/layout.erb</tt> quand ce fichier existe).
 
-Toute option que Sinatra ne comprends pas sera passée au moteur de rendu :
+Toute option que Sinatra ne comprend pas sera passée au moteur de rendu :
 
   get '/' do
     haml :index, :format => :html5
@@ -280,8 +319,8 @@ Options disponibles :
 
 [layout]
   S'il faut ou non utiliser un +layout+ (+true+ or +false+). Indique le
-  template à utiliser lorsque c'est un Symbol. Exemple : <tt>erb :index,
-  :layout => request.xhr?</tt>.
+  template à utiliser lorsque c'est un symbole. Exemple : <tt>erb :index,
+  :layout => !request.xhr?</tt>.
 
 [content_type]
   Content-Type que le template produit, dépend par défaut du langage de
@@ -302,17 +341,17 @@ Les templates sont supposés se trouver directement dans le dossier
 
   set :views, settings.root + '/templates'
 
-Il est important de noter que les templates sont toujours référencés
-sous forme de symboles, même s'il s'agit d'un sous-répertoire (dans ce
-cas, utilisez <tt>:'sous_repertoire/template'</tt>). Vous devez utiliser un
-symbole car les méthodes de rendu évalueront le contenu des chaînes de
+Il est important de se souvenir que les templates sont toujours référencés
+sous forme de symboles, même lorsqu'ils sont dans un sous-répertoire (dans
+ce cas, utilisez <tt>:'sous_repertoire/template'</tt>). Il faut utiliser
+un symbole car les méthodes de rendu évaluent le contenu des chaînes de
 caractères au lieu de les considérer comme un chemin vers un fichier.
 
 === Langages de template disponibles
 
 Certains langages ont plusieurs implémentations. Pour préciser l'implémentation
-à utiliser (et garantir l'aspect thread-safe), vous devriez simplement la
-charger au préalable :
+à utiliser (et garantir l'aspect thread-safe), vous devez simplement l'avoir
+chargée au préalable :
 
   require 'rdiscount' # ou require 'bluecloth'
   get('/') { markdown :index }
@@ -327,7 +366,7 @@ Exemple::                 <tt>haml :index, :format => :html5</tt>
 
 Dépendances::             {erubis}[http://www.kuwata-lab.com/erubis/] ou
                           erb (inclus avec Ruby)
-Extensions de fichier::   <tt>.erb</tt>, <tt>.rhtml</tt> or <tt>.erubis</tt>
+Extensions de fichier::   <tt>.erb</tt>, <tt>.rhtml</tt> ou <tt>.erubis</tt>
                           (Erubis seulement)
 Exemple::                 <tt>erb :index</tt>
 
@@ -335,7 +374,7 @@ Exemple::                 <tt>erb :index</tt>
 
 Dépendances::             {builder}[http://builder.rubyforge.org/]
 Extensions de fichier::   <tt>.builder</tt>
-Exemple::                 <tt>builder { |xml| xml.em "hi" }</tt>
+Exemple::                 <tt>builder { |xml| xml.em "salut" }</tt>
 
 Ce moteur accepte également un bloc pour des templates en ligne (voir exemple).
 
@@ -343,7 +382,7 @@ Ce moteur accepte également un bloc pour des templates en ligne (voir exemple).
 
 Dépendances::             {nokogiri}[http://nokogiri.org/]
 Extensions de fichier::   <tt>.nokogiri</tt>
-Exemple::                 <tt>builder { |xml| xml.em "hi" }</tt>
+Exemple::                 <tt>builder { |xml| xml.em "salut" }</tt>
 
 Ce moteur accepte également un bloc pour des templates en ligne (voir exemple).
 
@@ -381,10 +420,10 @@ Dépendances::             {rdiscount}[https://github.com/rtomayko/rdiscount],
                           {bluecloth}[http://deveiate.org/projects/BlueCloth],
                           {kramdown}[http://kramdown.rubyforge.org/] *ou*
                           {maruku}[http://maruku.rubyforge.org/]
-Extensions de fichier::   <tt>.markdown</tt>, <tt>.mkd</tt> and <tt>.md</tt>
+Extensions de fichier::   <tt>.markdown</tt>, <tt>.mkd</tt> et <tt>.md</tt>
 Exemple::                 <tt>markdown :index, :layout_engine => :erb</tt>
 
-Il n'est pas possible d'appeler des méthodes depuis markdown, ni même de lui
+Il n'est pas possible d'appeler des méthodes depuis markdown, ni de lui
 passer des variables locales. Par conséquent, il sera souvent utilisé en
 combinaison avec un autre moteur de rendu :
 
@@ -398,8 +437,8 @@ templates :
 
 Comme vous ne pouvez pas appeler de Ruby au sein de Markdown, vous ne pouvez
 pas utiliser de +layouts+ écrits en Markdown. Toutefois, il est possible
-d'utiliser un autre moteur de rendu pour le template que pour le +layout+ en
-utilisant l'option <tt>:layout_engine</tt>.
+d'utiliser un moteur de rendu différent pour le template et pour le +layout+
+en utilisant l'option <tt>:layout_engine</tt>.
 
 === Templates Textile
 
@@ -407,7 +446,7 @@ Dépendances::             {RedCloth}[http://redcloth.org/]
 Extensions de fichier::   <tt>.textile</tt>
 Exemple::                 <tt>textile :index, :layout_engine => :erb</tt>
 
-Il n'est pas possible d'appeler des méthodes depuis textile, ni même de lui
+Il n'est pas possible d'appeler des méthodes depuis textile, ni de lui
 passer des variables locales. Par conséquent, il sera souvent utilisé en
 combinaison avec un autre moteur de rendu :
 
@@ -421,16 +460,16 @@ templates :
 
 Comme vous ne pouvez pas appeler de Ruby au sein de Textile, vous ne pouvez
 pas utiliser de +layouts+ écrits en Textile. Toutefois, il est possible
-d'utiliser un autre moteur de rendu pour le template que pour le +layout+ en
-utilisant l'option <tt>:layout_engine</tt>.
+d'utiliser un moteur de rendu différent pour le template et pour le +layout+
+en utilisant l'option <tt>:layout_engine</tt>.
 
 === Templates RDoc
 
 Dépendances::             {rdoc}[http://rdoc.rubyforge.org/]
 Extensions de fichier::   <tt>.rdoc</tt>
-Exemple::                 <tt>textile :README, :layout_engine => :erb</tt>
+Exemple::                 <tt>rdoc :README, :layout_engine => :erb</tt>
 
-Il n'est pas possible d'appeler des méthodes depuis rdoc, ni même de lui
+Il n'est pas possible d'appeler des méthodes depuis rdoc, ni de lui
 passer des variables locales. Par conséquent, il sera souvent utilisé en
 combinaison avec un autre moteur de rendu :
 
@@ -444,8 +483,8 @@ templates :
 
 Comme vous ne pouvez pas appeler de Ruby au sein de RDoc, vous ne pouvez
 pas utiliser de +layouts+ écrits en RDoc. Toutefois, il est possible
-d'utiliser un autre moteur de rendu pour le template que pour le +layout+ en
-utilisant l'option <tt>:layout_engine</tt>.
+d'utiliser un moteur de rendu différent pour le template et pour le +layout+
+en utilisant l'option <tt>:layout_engine</tt>.
 
 === Templates Radius
 
@@ -454,7 +493,7 @@ Extensions de fichier::   <tt>.radius</tt>
 Exemple::                 <tt>radius :index, :locals => { :key => 'value' }</tt>
 
 Comme vous ne pouvez pas appeler de méthodes Ruby depuis un template Radius,
-vous aurez sûrement à lui passer des variables locales
+vous aurez sûrement à lui passer des variables locales.
 
 === Templates Markaby
 
@@ -476,7 +515,7 @@ Dépendances::             {creole}[https://github.com/minad/creole]
 Extensions de fichier::   <tt>.creole</tt>
 Exemple::                 <tt>creole :wiki, :layout_engine => :erb</tt>
 
-Il n'est pas possible d'appeler des méthodes depuis creole, ni même de lui
+Il n'est pas possible d'appeler des méthodes depuis creole, ni de lui
 passer des variables locales. Par conséquent, il sera souvent utilisé en
 combinaison avec un autre moteur de rendu :
 
@@ -490,8 +529,8 @@ templates :
 
 Comme vous ne pouvez pas appeler de Ruby au sein de Creole, vous ne pouvez
 pas utiliser de +layouts+ écrits en Creole. Toutefois, il est possible
-d'utiliser un autre moteur de rendu pour le template que pour le +layout+ en
-utilisant l'option <tt>:layout_engine</tt>.
+d'utiliser un moteur de rendu différent pour le template et pour le +layout+
+en utilisant l'option <tt>:layout_engine</tt>.
 
 === Templates CoffeeScript
 
@@ -506,7 +545,7 @@ Exemple::                 <tt>coffee :index</tt>
     haml '%div.title Bonjour le monde'
   end
 
-Générera le template embarqué spécifié dans la chaîne de caractères.
+Générera le code du template spécifié dans la chaîne de caractères.
 
 === Accéder aux variables dans un Template
 
@@ -718,7 +757,7 @@ Si vous souhaitez avoir plus de contrôle, vous pouvez également enregistrer un
 
   set :sessions, :domain => 'foo.com'
 
-== Halt
+=== Halt
 
 Pour arrêter immédiatement la requête dans un filtre ou un gestionnaire de
 route :
@@ -745,7 +784,7 @@ Bien sûr il est possible de combiner un template avec +halt+ :
 
   halt erb(:erreur)
 
-== Passer
+=== Passer
 
 Une route peut passer le relais aux autres routes qui correspondent également
 avec <tt>pass</tt> :
@@ -816,7 +855,7 @@ retour et les entêtes :
   get '/foo' do
     status 418
     headers \
-      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN"
+      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN",
       "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
     body "Je suis une théière !"
   end
@@ -824,6 +863,56 @@ retour et les entêtes :
 Comme +body+, +headers+ et +status+ peuvent être utilisés sans arguments
 pour accéder à leurs valeurs.
 
+=== Faire du streaming
+
+Il y a des cas où vous voulez commencer à renvoyer des données pendant que
+vous êtes en train de générer le reste de la réponse. Dans les cas les plus
+extrèmes, vous souhaitez continuer à envoyer des données tant que le client
+n'abandonne pas la connection. Vous pouvez alors utiliser le helper +stream+
+pour éviter de créer votre propre système :
+
+  get '/' do
+    stream do |out|
+      out << "Ca va être hallu -\n"
+      sleep 0.5
+      out << " (attends la suite) \n"
+      sleep 1
+      out << "- cinant !\n"
+    end
+  end
+
+Cela permet d'implémenter des API de streaming ou de
+{Server Sent Events}[http://dev.w3.org/html5/eventsource/] et peut servir de
+base pour des {WebSockets}[http://en.wikipedia.org/wiki/WebSocket]. Vous
+pouvez aussi l'employer pour augmenter le débit quand une partie du contenu
+provient d'une resource lente.
+
+Le fonctionnement du streaming, notamment le nombre de requêtes simultanées,
+dépend énormément du serveur web utilisé. Certains ne prennent pas du tout en
+charge le streaming (WEBRick par exemple). Lorsque le serveur ne gère pas le
+streaming, la partie body de la réponse sera envoyée au client en une seule
+fois, après que l'exécution du bloc passé au helper +stream+ sera terminée.
+
+En utilisant le helper +stream+ avec le paramètre +keep_open+, il n'appelera
+pas la méthode +close+ du flux, vous laissant la possibilité de le fermer à
+tout moment au cours de l'exécution. Ceci ne fonctionne qu'avec les serveurs
+evented (ie non threadés) tels que Thin et Rainbows. Les autres serveurs
+fermeront malgré tout le flux.
+
+  set :server, :thin
+  connections = []
+
+  get '/' do
+    # conserve le flux ouvert
+    stream(:keep_open) { |out| connections << out }
+  end
+
+  post '/' do
+    # écrit dans tous les flux ouverts
+    connections.each { |out| out << params[:message] << "\n" }
+    "message sent"
+  end
+
 === Journalisation (Logging)
 
 Dans le contexte de la requête, la méthode utilitaire +logger+ expose une
@@ -911,7 +1000,7 @@ Pour passer des arguments à une redirection, ajoutez-les soit à la requête :
 
 Ou bien utilisez une session :
 
-  enable :session
+  enable :sessions
 
   get '/foo' do
     session[:secret] = 'foo'
@@ -946,7 +1035,7 @@ Si vous utilisez la méthode +expires+ pour définir l'entête correspondant,
     expires 500, :public, :must_revalidate
   end
 
-Pour utiliser correctement les caches, vous devriez utiliser +etag+ et
+Pour utiliser correctement les caches, vous devriez utiliser +etag+ ou
 +last_modified+. Il est recommandé d'utiliser ces méthodes *avant* de faire
 d'importantes modifications, car elles vont immédiatement déclencher la réponse
 si le client a déjà la version courante dans son cache :
@@ -965,7 +1054,7 @@ Il est également possible d'utiliser un
 
 Ces méthodes ne sont pas chargées de mettre des données en cache, mais elles
 fournissent les informations nécessaires pour votre cache. Si vous êtes à la
-recherche de solutions rapides de cache, essayez
+recherche de solutions rapides pour un reverse-proxy de cache, essayez
 {rack-cache}[http://rtomayko.github.com/rack-cache/] :
 
   require "rack/cache"
@@ -1016,7 +1105,7 @@ Si le gestionnaire Rack le supporte, d'autres moyens que le +streaming+ via le
 processus Ruby seront utilisés. Si vous utilisez cette méthode, Sinatra gérera
 automatiquement les requêtes de type +range+.
 
-== Accéder à l'objet requête
+=== Accéder à l'objet requête
 
 L'objet correspondant à la requête envoyée peut être récupéré dans le contexte
 de la requête (filtres, routes, gestionnaires d'erreur) au moyen de la méthode
@@ -1090,6 +1179,38 @@ Vous pouvez également lui passer un nom de fichier :
     "enregistre-le !"
   end
 
+=== Gérer Date et Time
+
+Sinatra fourni un helper +time_for+ pour convertir une valeur donnée en
+objet +Time+. Il peut aussi faire la conversion à partir d'objets +DateTime+,
++Date+ ou de classes similaires.
+
+  get '/' do
+    pass if Time.now > time_for('Dec 23, 2012')
+    "encore temps"
+  end
+
+Cette méthode est utilisée en interne par +expires+, +last_modified+ et
+consorts. Par conséquent, vous pouvez très facilement étendre le
+fonctionnement de ces méthodes en surchargeant le helper +time_for+ dans
+votre application :
+
+  helpers do
+    def time_for(value)
+      case value
+      when :yesterday then Time.now - 24*60*60
+      when :tomorrow  then Time.now + 24*60*60
+      else super
+      end
+    end
+  end
+
+  get '/' do
+    last_modified :yesterday
+    expires :tomorrow
+    "salut"
+  end
+
 === Chercher les fichiers de templates
 
 La méthode <tt>find_template</tt> est utilisée pour trouver les fichiers de
@@ -1243,7 +1364,7 @@ Vous pouvez accéder à ces paramètres via <tt>settings</tt> :
                       comportera comme <tt>redirect to('/foo')</tt>.
                       Désactivé par défaut.
 
-[public]              dossier duquel les fichiers publics sont servis
+[public_folder]       dossier duquel les fichiers publics sont servis
 
 [reload_templates]    si oui ou non les templates doivent être rechargés
                       entre les requêtes. Activé en mode développement.
@@ -1275,6 +1396,9 @@ Vous pouvez accéder à ces paramètres via <tt>settings</tt> :
                       Activé par défaut pour le style classique, désactivé pour
                       le style modulaire.
 
+[threaded]            à définir à +true+ pour indiquer à Thin d'utiliser
+                      <tt>EventMachine.defer</tt> pour traiter la requête.
+
 [views]               dossier des vues.
 
 == Gérer les erreurs
@@ -1585,6 +1709,7 @@ sans avoir à les assigner à une constante, vous pouvez le faire grâce à
 
 L'application dont elle hérite peut être passé en argument optionnel :
 
+  # config.ru
   require 'sinatra/base'
 
   controleur = Sinatra.new do