Skip to content
Browse files

Merge pull request #558 from burningTyger/master

README update and typo
  • Loading branch information...
2 parents f3007c0 + 8a216bc commit d1e72d30b4a7572922781543cf8d12e9a0cb6710 @rkh rkh committed
Showing with 62 additions and 46 deletions.
  1. +45 −29 README.de.rdoc
  2. +17 −17 README.rdoc
View
74 README.de.rdoc
@@ -361,21 +361,21 @@ Beginn ein 'require':
=== Haml Templates
Abhängigkeit:: {haml}[http://haml.info/]
-Dateierweiterungs:: <tt>.haml</tt>
+Dateierweiterung:: <tt>.haml</tt>
Beispiel:: <tt>haml :index, :format => :html5</tt>
=== Erb Templates
Abhängigkeit:: {erubis}[http://www.kuwata-lab.com/erubis/] oder
- erb (included in Ruby)
-Dateierweiterungs:: <tt>.erb</tt>, <tt>.rhtml</tt> oder <tt>.erubis</tt>
- (nur Erubis)
-Beispiel:: <tt>erb :index</tt>
+ erb (included in Ruby)
+Dateierweiterungen:: <tt>.erb</tt>, <tt>.rhtml</tt> oder <tt>.erubis</tt>
+ (nur Erubis)
+Beispiel:: <tt>erb :index</tt>
=== Builder Templates
Abhängigkeit:: {builder}[http://builder.rubyforge.org/]
-Dateierweiterungs:: <tt>.builder</tt>
+Dateierweiterung:: <tt>.builder</tt>
Beispiel:: <tt>builder { |xml| xml.em "Hallo" }</tt>
Nimmt ebenso einen Block für Inline-Templates entgegen (siehe Beispiel).
@@ -383,7 +383,7 @@ Nimmt ebenso einen Block für Inline-Templates entgegen (siehe Beispiel).
=== Nokogiri Templates
Abhängigkeit:: {nokogiri}[http://nokogiri.org/]
-Dateierweiterungs:: <tt>.nokogiri</tt>
+Dateierweiterung:: <tt>.nokogiri</tt>
Beispiel:: <tt>nokogiri { |xml| xml.em "Hallo" }</tt>
Nimmt ebenso einen Block für Inline-Templates entgegen (siehe Beispiel).
@@ -391,25 +391,25 @@ Nimmt ebenso einen Block für Inline-Templates entgegen (siehe Beispiel).
=== Sass Templates
Abhängigkeit:: {sass}[http://sass-lang.com/]
-Dateierweiterungs:: <tt>.sass</tt>
+Dateierweiterung:: <tt>.sass</tt>
Beispiel:: <tt>sass :stylesheet, :style => :expanded</tt>
=== SCSS Templates
Abhängigkeit:: {sass}[http://sass-lang.com/]
-Dateierweiterungs:: <tt>.scss</tt>
+Dateierweiterung:: <tt>.scss</tt>
Beispiel:: <tt>scss :stylesheet, :style => :expanded</tt>
=== Less Templates
Abhängigkeit:: {less}[http://www.lesscss.org/]
-Dateierweiterungs:: <tt>.less</tt>
+Dateierweiterung:: <tt>.less</tt>
Beispiel:: <tt>less :stylesheet</tt>
=== Liquid Templates
Abhängigkeit:: {liquid}[http://www.liquidmarkup.org/]
-Dateierweiterungs:: <tt>.liquid</tt>
+Dateierweiterung:: <tt>.liquid</tt>
Beispiel:: <tt>liquid :index, :locals => { :key => 'Wert' }</tt>
Da man aus dem Liquid-Template heraus keine Ruby-Methoden aufrufen kann
@@ -419,11 +419,11 @@ denen man Variablen weitergibt.
=== Markdown Templates
Abhängigkeit:: {rdiscount}[https://github.com/rtomayko/rdiscount],
- {redcarpet}[https://github.com/tanoku/redcarpet],
- {bluecloth}[http://deveiate.org/projects/BlueCloth],
- {kramdown}[http://kramdown.rubyforge.org/] *oder*
- {maruku}[http://maruku.rubyforge.org/]
-Dateierweiterungs:: <tt>.markdown</tt>, <tt>.mkd</tt> und <tt>.md</tt>
+ {redcarpet}[https://github.com/tanoku/redcarpet],
+ {bluecloth}[http://deveiate.org/projects/BlueCloth],
+ {kramdown}[http://kramdown.rubyforge.org/] *oder*
+ {maruku}[http://maruku.rubyforge.org/]
+Dateierweiterungen:: <tt>.markdown</tt>, <tt>.mkd</tt> und <tt>.md</tt>
Beispiel:: <tt>markdown :index, :layout_engine => :erb</tt>
Da man aus den Markdown-Templates heraus keine Ruby-Methoden aufrufen und auch
@@ -446,7 +446,7 @@ Templates zu verwenden und einen anderen für das Layout, indem die
=== Textile Templates
Abhängigkeit:: {RedCloth}[http://redcloth.org/]
-Dateierweiterungs:: <tt>.textile</tt>
+Dateierweiterung:: <tt>.textile</tt>
Beispiel:: <tt>textile :index, :layout_engine => :erb</tt>
Da man aus dem Textile-Template heraus keine Ruby-Methoden aufrufen und auch
@@ -469,7 +469,7 @@ Templates zu verwenden und einen anderen für das Layout, indem die
=== RDoc Templates
Abhängigkeit:: {rdoc}[http://rdoc.rubyforge.org/]
-Dateierweiterungs:: <tt>.rdoc</tt>
+Dateierweiterung:: <tt>.rdoc</tt>
Beispiel:: <tt>textile :README, :layout_engine => :erb</tt>
Da man aus dem RDoc-Template heraus keine Ruby-Methoden aufrufen und auch
@@ -492,7 +492,7 @@ Templates zu verwenden und einen anderen für das Layout, indem die
=== Radius Templates
Abhängigkeit:: {radius}[http://radius.rubyforge.org/]
-Dateierweiterungs:: <tt>.radius</tt>
+Dateierweiterung:: <tt>.radius</tt>
Beispiel:: <tt>radius :index, :locals => { :key => 'Wert' }</tt>
Da man aus dem Radius-Template heraus keine Ruby-Methoden aufrufen kann, wird
@@ -501,27 +501,27 @@ man üblicherweise locals verwenden wollen, mit denen man Variablen weitergibt.
=== Markaby Templates
Abhängigkeit:: {markaby}[http://markaby.github.com/]
-Dateierweiterungs:: <tt>.mab</tt>
+Dateierweiterung:: <tt>.mab</tt>
Beispiel:: <tt>markaby { h1 "Willkommen!" }</tt>
Nimmt ebenso einen Block für Inline-Templates entgegen (siehe Beispiel).
-=== Slim Templates
+=== RABL Templates
Abhängigkeit:: {rabl}[https://github.com/nesquena/rabl]
-Dateierweiterungs:: <tt>.rabl</tt>
+Dateierweiterung:: <tt>.rabl</tt>
Beispiel:: <tt>rabl :index</tt>
=== Slim Templates
Abhängigkeit:: {slim}[http://slim-lang.com/]
-Dateierweiterungs:: <tt>.slim</tt>
+Dateierweiterung:: <tt>.slim</tt>
Beispiel:: <tt>slim :index</tt>
=== Creole Templates
Abhängigkeit:: {creole}[https://github.com/minad/creole]
-Dateierweiterungs:: <tt>.creole</tt>
+Dateierweiterung:: <tt>.creole</tt>
Beispiel:: <tt>creole :wiki, :layout_engine => :erb</tt>
Da man aus dem Creole-Template heraus keine Ruby-Methoden aufrufen und auch
@@ -545,8 +545,18 @@ Templates zu verwenden und einen anderen für das Layout, indem die
Abhängigkeit:: {coffee-script}[https://github.com/josh/ruby-coffee-script]
und eine {Möglichkeit JavaScript auszuführen}[https://github.com/sstephenson/execjs/blob/master/README.md#readme]
-Dateierweiterungs:: <tt>.coffee</tt>
-Beispiel:: <tt>coffee :index</tt>
+Dateierweiterung:: <tt>.coffee</tt>
+Beispiel:: <tt>coffee :index</tt>
+
+=== WLang Templates
+
+Abhängigkeit:: {wlang}[https://github.com/blambeau/wlang/]
+Dateierweiterung:: <tt>.wlang</tt>
+Beispiel:: <tt>wlang :index, :locals => { :key => 'value' }</tt>
+
+Ruby-Methoden in wlang aufzurufen entspricht nicht den idiomatischen Vorgaben
+von wlang, es bietet sich deshalb an, <tt>:locals</tt> zu verwenden.
+Layouts, die wlang und +yield+ verwenden, werden aber trotzdem unterstützt.
=== Eingebettete Templates
@@ -1327,8 +1337,9 @@ Diese Einstellungen sind über +settings+ erreichbar:
Sinatra verwendet
{Rack::Protection}[https://github.com/rkh/rack-protection#readme], um die
Anwendung vor häufig vorkommenden Angriffen zu schützen. Diese Voreinstellung
-lässt sich selbstverständlich auch deaktivieren, z.B. um
-Geschwindigkeitsvorteile zu gewinnen:
+lässt sich selbstverständlich deaktivieren, der damit verbundene
+Geschwindigkeitszuwachs steht aber in keinem Verhätnis zu den möglichen
+Risiken.
disable :protection
@@ -1417,6 +1428,8 @@ Schutzmechanismen zu deaktivieren:
Option). Leitet sich von der <tt>app_file</tt>
Einstellung ab, wenn nicht gesetzt.
+[public_dir] Alias für <tt>public_folder</tt>, s.o.
+
[reload_templates] Im development-Modus aktiviert.
[root] Wurzelverzeichnis des Projekts. Leitet sich von der
@@ -1448,7 +1461,10 @@ Schutzmechanismen zu deaktivieren:
automatisch aktiviert, wenn die Umgebung auf
<tt>"development"</tt> eingestellt ist. Ansonsten ist
diese Option deaktiviert.
-
+ Kann auch auf <tt>:after_handler</tt> gestellt werden,
+ um eine anwendungsspezifische Fehlerbehandlung
+ auszulösen, bevor der Fehlerverlauf im Browser
+ angezeigt wird.
[static] Entscheidet, ob Sinatra statische Dateien zur Verfügung
stellen soll oder nicht.
View
34 README.rdoc
@@ -345,7 +345,7 @@ to use (and to be thread-safe), you should simply require it first:
=== Haml Templates
Dependency:: {haml}[http://haml.info/]
-File Extensions:: <tt>.haml</tt>
+File Extension:: <tt>.haml</tt>
Example:: <tt>haml :index, :format => :html5</tt>
=== Erb Templates
@@ -359,7 +359,7 @@ Example:: <tt>erb :index</tt>
=== Builder Templates
Dependency:: {builder}[http://builder.rubyforge.org/]
-File Extensions:: <tt>.builder</tt>
+File Extension:: <tt>.builder</tt>
Example:: <tt>builder { |xml| xml.em "hi" }</tt>
It also takes a block for inline templates (see example).
@@ -367,7 +367,7 @@ It also takes a block for inline templates (see example).
=== Nokogiri Templates
Dependency:: {nokogiri}[http://nokogiri.org/]
-File Extensions:: <tt>.nokogiri</tt>
+File Extension:: <tt>.nokogiri</tt>
Example:: <tt>nokogiri { |xml| xml.em "hi" }</tt>
It also takes a block for inline templates (see example).
@@ -375,25 +375,25 @@ It also takes a block for inline templates (see example).
=== Sass Templates
Dependency:: {sass}[http://sass-lang.com/]
-File Extensions:: <tt>.sass</tt>
+File Extension:: <tt>.sass</tt>
Example:: <tt>sass :stylesheet, :style => :expanded</tt>
=== SCSS Templates
Dependency:: {sass}[http://sass-lang.com/]
-File Extensions:: <tt>.scss</tt>
+File Extension:: <tt>.scss</tt>
Example:: <tt>scss :stylesheet, :style => :expanded</tt>
=== Less Templates
Dependency:: {less}[http://www.lesscss.org/]
-File Extensions:: <tt>.less</tt>
+File Extension:: <tt>.less</tt>
Example:: <tt>less :stylesheet</tt>
=== Liquid Templates
Dependency:: {liquid}[http://www.liquidmarkup.org/]
-File Extensions:: <tt>.liquid</tt>
+File Extension:: <tt>.liquid</tt>
Example:: <tt>liquid :index, :locals => { :key => 'value' }</tt>
Since you cannot call Ruby methods (except for +yield+) from a Liquid
@@ -427,7 +427,7 @@ template than for the layout by passing the <tt>:layout_engine</tt> option.
=== Textile Templates
Dependency:: {RedCloth}[http://redcloth.org/]
-File Extensions:: <tt>.textile</tt>
+File Extension:: <tt>.textile</tt>
Example:: <tt>textile :index, :layout_engine => :erb</tt>
It is not possible to call methods from textile, nor to pass locals to it. You
@@ -447,7 +447,7 @@ template than for the layout by passing the <tt>:layout_engine</tt> option.
=== RDoc Templates
Dependency:: {rdoc}[http://rdoc.rubyforge.org/]
-File Extensions:: <tt>.rdoc</tt>
+File Extension:: <tt>.rdoc</tt>
Example:: <tt>rdoc :README, :layout_engine => :erb</tt>
It is not possible to call methods from rdoc, nor to pass locals to it. You
@@ -467,7 +467,7 @@ template than for the layout by passing the <tt>:layout_engine</tt> option.
=== Radius Templates
Dependency:: {radius}[http://radius.rubyforge.org/]
-File Extensions:: <tt>.radius</tt>
+File Extension:: <tt>.radius</tt>
Example:: <tt>radius :index, :locals => { :key => 'value' }</tt>
Since you cannot call Ruby methods directly from a Radius template, you almost
@@ -476,7 +476,7 @@ always want to pass locals to it.
=== Markaby Templates
Dependency:: {markaby}[http://markaby.github.com/]
-File Extensions:: <tt>.mab</tt>
+File Extension:: <tt>.mab</tt>
Example:: <tt>markaby { h1 "Welcome!" }</tt>
It also takes a block for inline templates (see example).
@@ -484,19 +484,19 @@ It also takes a block for inline templates (see example).
=== RABL Templates
Dependency:: {rabl}[https://github.com/nesquena/rabl]
-File Extensions:: <tt>.rabl</tt>
+File Extension:: <tt>.rabl</tt>
Example:: <tt>rabl :index</tt>
=== Slim Templates
Dependency:: {slim}[http://slim-lang.com/]
-File Extensions:: <tt>.slim</tt>
+File Extension:: <tt>.slim</tt>
Example:: <tt>slim :index</tt>
=== Creole Templates
Dependency:: {creole}[https://github.com/minad/creole]
-File Extensions:: <tt>.creole</tt>
+File Extension:: <tt>.creole</tt>
Example:: <tt>creole :wiki, :layout_engine => :erb</tt>
It is not possible to call methods from creole, nor to pass locals to it. You
@@ -517,13 +517,13 @@ template than for the layout by passing the <tt>:layout_engine</tt> option.
Dependency:: {coffee-script}[https://github.com/josh/ruby-coffee-script]
and a {way to execute javascript}[https://github.com/sstephenson/execjs/blob/master/README.md#readme]
-File Extensions:: <tt>.coffee</tt>
+File Extension:: <tt>.coffee</tt>
Example:: <tt>coffee :index</tt>
=== Yajl Templates
Dependency:: {yajl-ruby}[https://github.com/brianmario/yajl-ruby]
-File Extensions:: <tt>.yajl</tt>
+File Extension:: <tt>.yajl</tt>
Example:: <tt>yajl :index, :locals => { :key => 'qux' }, :callback => 'present', :variable => 'resource' </tt>
The template source is evaluated as a Ruby string, and the resulting json variable is converted #to_json.
@@ -538,7 +538,7 @@ The <tt>:callback</tt> and <tt>:variable</tt> options can be used to decorate th
=== WLang Templates
Dependency:: {wlang}[https://github.com/blambeau/wlang/]
-File Extensions:: <tt>.wlang</tt>
+File Extension:: <tt>.wlang</tt>
Example:: <tt>wlang :index, :locals => { :key => 'value' }</tt>
Since calling ruby methods is not idiomatic in wlang, you almost always want to pass locals

0 comments on commit d1e72d3

Please sign in to comment.
Something went wrong with that request. Please try again.