slim 2.0.2 → 2.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e8b90e64b7eb12f2d3c66b7f1141a757d7314df8
-  data.tar.gz: e695b95196c24065d593af6dbc2da8d122b6b0e1
+  metadata.gz: 58912f8464de3ff74107a9ded1bf191b976cb7b3
+  data.tar.gz: aaf442c2a361a88e18dea6622e79cd9184369ab8
 SHA512:
-  metadata.gz: 43864aaeb0b17561f3a742be6a2324213be8aefa19ee751f7ded2fef9018effb46bc095a8f756af696eb2c835fb3035df33bbb254781e1ebcd52ac36aef20df4
-  data.tar.gz: 5e9ca23904c3c810069605133d41e3770ab6b4349e926328b219c7b3ecf5da99b4a850a38064913082e8d2d4df2bf59e7016c790ae91f717b59e3af3f7a45a25
+  metadata.gz: 9c6b789d0f7d192a1edc2461a03cba9fde694498893514c51f91db6f21f1941f72c7ddc6ca2cd562bb013b2d217488b1264d1236956f44be7ec3c50c5802f012
+  data.tar.gz: 1975be4161db643822c4e3c3269725d32cc94d4e692b217d71cf69af0f82e1982dbf0ab0720763094799a8f9c3f1683dda0d41c0e98b083971a35e914d46d777

data/.travis.yml

@@ -3,24 +3,25 @@ rvm:
   - 1.8.7
   - 1.9.3
   - 2.0.0
+  - 2.1.0
   - ruby-head
   - jruby-18mode
   - jruby-19mode
-  - rbx-18mode
-  - rbx-19mode
+  - rbx-2
 env:
   - "TASK=test:core_and_plugins TILT=master"
-  - "TASK=test:core_and_plugins TILT=1.3.4"
+  - "TASK=test:core_and_plugins TILT=1.3.7"
   - "TASK=test:core_and_plugins TILT=1.4.1"
-  - "TASK=test:core_and_plugins TILT=2.0.0.beta1"
+  - "TASK=test:core_and_plugins TILT=2.0.1"
   - "TASK=test:rails RAILS=master"
   - "TASK=test:rails RAILS=3.0.20"
-  - "TASK=test:rails RAILS=3.1.12"
-  - "TASK=test:rails RAILS=3.2.13"
-  - "TASK=test:rails RAILS=4.0.0"
+  - "TASK=test:rails RAILS=3.1.12 TILT=1.3.4"
+  - "TASK=test:rails RAILS=3.2.17 TILT=1.3.4"
+  - "TASK=test:rails RAILS=4.0.4"
+  - "TASK=test:rails RAILS=4.1.0"
   - "TASK=test:sinatra SINATRA=master"
   - "TASK=test:sinatra SINATRA=1.3.6"
-  - "TASK=test:sinatra SINATRA=1.4.2"
+  - "TASK=test:sinatra SINATRA=1.4.5"
   - "TASK=bench iterations=10000"
   - "TASK=bench slow=1 iterations=1000"
 matrix:
@@ -30,14 +31,16 @@ matrix:
       env: "TASK=test:rails RAILS=master"
     - rvm: jruby-18mode
       env: "TASK=test:rails RAILS=master"
-    - rvm: rbx-18mode
+    - rvm: rbx-2
       env: "TASK=test:rails RAILS=master"
     - rvm: 1.8.7
-      env: "TASK=test:rails RAILS=4.0.0"
+      env: "TASK=test:rails RAILS=4.0.4"
+    - rvm: 1.8.7
+      env: "TASK=test:rails RAILS=4.1.0"
+    - rvm: jruby-18mode
+      env: "TASK=test:rails RAILS=4.0.4"
     - rvm: jruby-18mode
-      env: "TASK=test:rails RAILS=4.0.0"
-    - rvm: rbx-18mode
-      env: "TASK=test:rails RAILS=4.0.0"
+      env: "TASK=test:rails RAILS=4.1.0"
   allow_failures:
     - env: "TASK=test:core_and_plugins TILT=master"
     - env: "TASK=test:rails RAILS=master"

data/CHANGES

@@ -1,3 +1,12 @@
+2.0.3
+
+  * slimrb: Don't update HTML output on exceptions
+  * Allow dashes at the beginning of class names (#474)
+  * Render empty attributes as standalone in html mode (#480)
+  * Fix #482: problem with whitespace modifier `tag=<`
+  * Fix #485: missing end for empty `if` control blocks
+  * Fix #510: double dash in class name
+
 2.0.2
 
   * Add option :attr_delims

data/Gemfile

@@ -24,6 +24,13 @@ if ENV['RAILS']
   end
 end
 
+#Choose minitest 4.7.x for sinatra or rails 3 and 4.0 otherwise go for newer version
+if ENV['SINATRA'] || (ENV['RAILS'] && !ENV['RAILS'].match(/4\.([1-9])(\..*)?/))
+  gem 'minitest', '~> 4.7.4'
+else
+  gem 'minitest', '~> 5.1'
+end
+
 if ENV['SINATRA']
   gem 'rack-test'
   if ENV['SINATRA'] == 'master'
@@ -40,9 +47,8 @@ gem 'creole'
 gem 'builder'
 gem 'asciidoctor'
 gem 'org-ruby'
-gem 'minitest', '~> 4.7.4'
 
 if ENV['TASK'] == 'bench'
   gem 'erubis'
   gem 'haml'
-end
+end

data/README.jp.md

@@ -0,0 +1,968 @@
+# Slim
+
+[![Gem Version](https://badge.fury.io/rb/slim.png)](http://rubygems.org/gems/slim) [![Build Status](https://secure.travis-ci.org/slim-template/slim.png?branch=master)](http://travis-ci.org/slim-template/slim) [![Dependency Status](https://gemnasium.com/slim-template/slim.png?travis)](https://gemnasium.com/slim-template/slim) [![Code Climate](https://codeclimate.com/github/slim-template/slim.png)](https://codeclimate.com/github/slim-template/slim) [![Gittip donate button](http://img.shields.io/gittip/bevry.png)](https://www.gittip.com/min4d/ "Donate weekly to this project using Gittip")
+[![Flattr donate button](https://raw.github.com/balupton/flattr-buttons/master/badge-89x18.gif)](https://flattr.com/submit/auto?user_id=min4d&url=http%3A%2F%2Fslim-lang.org%2F "Donate monthly to this project using Flattr")
+
+Slim は 不可解にならないように view の構文を本質的な部品まで減らすことを目指したテンプレート言語です。標準的な HTML テンプレートからどれだけのものが削除できるか確かめるところから始まりました。(<, >, 閉じタグなど) 多くの人が Slim に興味を持ったことで, 機能性は発展し, 柔軟な構文をもたらしました。
+
+機能の短いリスト
+
+* すっきりした構文
+    * 閉じタグの無い短い構文 (代わりにインデントを用いる)
+    * 閉じタグを用いた HTML 形式の構文
+    * 設定可能なショートカットタグ (デフォルトでは `#` は `<div id="...">` に, `.` は `<div class="...">` に)
+* 安全性
+    * デフォルトで自動 HTML エスケープ
+    * Rails の `html_safe?` に対応
+* プラグインを用いた柔軟な設定と拡張性
+    * Mustache のようなロジックレスモードをプラグインで実現
+    * 多言語化/I18n をプラグインで実現
+* 高性能
+    * ERB/Erubis に匹敵するスピード
+    * Rails のストリーミングに対応
+* 全てのメジャーフレームワークが対応 (Rails, Sinatra, ...)
+* Ruby 1.9 では タグや属性の Unicode に完全対応
+* Markdown や Textile のような埋め込みエンジン
+
+## リンク
+
+* ソース: <http://github.com/slim-template/slim>
+* バグ:   <http://github.com/slim-template/slim/issues>
+* リスト:   <http://groups.google.com/group/slim-template>
+* API ドキュメント:
+    * 最新の Gem: <http://rubydoc.info/gems/slim/frames>
+    * GitHub master: <http://rubydoc.info/github/slim-template/slim/master/frames>
+
+## イントロダクション
+
+### Slim とは?
+
+Slim は __Rails3 および 4__ に対応した高速, 軽量なテンプレートエンジンです。すべての主要な Ruby の実装でしっかりテストされています。
+私たちは継続的インテグレーションを採用しています。(travis-ci)
+
+Slim の核となる構文は1つの考えによって導かれます: "この動作を行うために最低限必要なものは何か"。
+
+多くの人々の Slim への貢献によって, 彼らが使う [Haml](https://github.com/haml/haml) や [Jade](https://github.com/visionmedia/jade) の影響を受け構文の追加が行われています。 Slim の開発チームは美は見る人の目の中にあることを分っているのでこういった追加にオープンです。
+
+Slim は 構文解析/コンパイルに [Temple](https://github.com/judofyr/temple) を使い [Tilt](https://github.com/rtomayko/tilt) に組み込まれます。これにより [Sinatra](https://github.com/sinatra/sinatra) やプレーンな [Rack](https://github.com/rack/rack) とも一緒に使えます。
+
+Temple のアーキテクチャはとても柔軟でモンキーパッチなしで構文解析とコンパイルのプロセスの拡張を可能にします。これはロジックレスのプラグインや I18n が提供する翻訳プラグインに
+使用されます。
+
+### なぜ Slim を使うのか?
+
+Rails コミュニティの中で, _Erb_ と _Haml_ は間違いなく最も人気がある2つのテンプレートエンジンです。しかしながら, _Erb_ の構文は扱いにくく, _Haml_ の構文は初心者にはとても謎めいている場合があります。
+
+ロジックレスエンジンのいくつかの発展もあります (例: 標準のHTMLを書かなければいけない [Mustache](https://github.com/defunkt/mustache))。あなたの好みで Slim の構文で HTML をビルドすることができます。Slim の構文で HTML をビルドすることが好きだけどテンプレートに Ruby のコードを書きたくない場合でも Slim のロジックレスモードを使うことができます。
+
+Slim は 最小限の構文とスピードをもたらすために生まれました。 もし Slim を選択しない場合, その理由はスピード以外の理由によるものでしょう。
+
+___そう, Slim は速い!___ ベンチマークはコミット毎に <http://travis-ci.org/slim-template/slim> で取られています。
+この数字が信じられませんか? それは仕方ないことです。是非 rake タスクを使って自分でベンチマークを取ってみてください!
+
+### どう始めるの?
+
+Slim を gem としてインストール:
+
+    gem install slim
+
+あなたの Gemfile に `gem 'slim'` と書いてインクルードするか, ファイルに `require 'slim'` と書く必要があります。これだけです! 後は拡張子に .slim を使うだけで準備はできています。
+
+### 構文例
+
+Slim テンプレートがどのようなものか簡単な例を示します:
+
+    doctype html
+    html
+      head
+        title Slim のファイル例
+        meta name="keywords" content="template language"
+        meta name="author" content=author
+        link rel="icon" type="image/png" href=file_path("favicon.png")
+        javascript:
+          alert('Slim は javascript の埋め込みに対応します!')
+
+      body
+        h1 マークアップ例
+
+        #content
+          p このマークアップ例はあなたに Slim の典型的なファイルがどのようなものか示します。
+
+        == yield
+
+        - if items.any?
+          table#items
+            - for item in items
+              tr
+                td.name = item.name
+                td.price = item.price
+        - else
+          p アイテムが見つかりませんでした。いくつか目録を追加してください。
+            ありがとう!
+
+        div id="footer"
+          == render 'footer'
+          | Copyright &copy; #{@year} #{@author}
+
+インデントについて, インデントの深さはあなたの好みで選択できます。もし最初のインデントをスペース2つ, その次に5スペースを使いたい場合, それはあなたの選択次第です。マークアップを入れ子にするにはスペース1つのインデントが必要なだけです。
+
+## ラインインジケータ
+
+### テキスト `|`
+
+パイプは Slim に行をコピーしろと命じます。基本的にどのような処理でもエスケープします。
+パイプよりも深くインデントされた各行がコピーされます。
+
+    body
+      p
+        |
+          これはテキストブロックのテストです。
+
+  構文解析結果は以下:
+
+    <body><p>これはテキストブロックのテストです。</p></body>
+
+  ブロックの左端はパイプ +1 スペースのインデントに設定されています。 
+  追加のスペースはコピーされます。
+
+    body
+      p
+        | この行は左端になります。
+            この行はスペース1つを持つことになります。
+              この行はスペース2つを持つことになります。
+                以下同様に...
+
+テキスト行に HTML を埋め込むこともできます。
+
+    - articles.each do |a|
+      | <tr><td>#{a.name}</td><td>#{a.description}</td></tr>
+
+### テキスト行のスペースをたどる `'`
+
+シングルクォートは Slim に行をコピーしろと命じます (`|` と同様に) が,  単一行の末尾にスペースが追加されているかチェックします。
+
+### インライン html `<` (HTML 形式)
+
+あなたは html タグを直接 Slim の中に書くことができます。Slim は閉じタグを使った html タグ形式や html と Slim を混ぜてテンプレートの中に書くことができます。
+
+    <html>
+      head
+        title 記述例
+      <body>
+        - if articles.empty?
+        - else
+          table
+            - articles.each do |a|
+              <tr><td>#{a.name}</td><td>#{a.description}</td></tr>
+      </body>
+    </html>
+
+### 制御コード `-`
+
+ダッシュは制御コードを意味します。制御コードの例としてループと条件文があります。`end` は `-` の後ろに置くことができません。ブロックはインデントによってのみ定義されます。
+複数行にわたる Ruby のコードが必要な場合, 行末にバックスラッシュ `\` を追加します。行末がカンマ `,` で終わる場合 (例 関数呼び出し) には行末にバックスラッシュを追加する必要はありません。
+
+    body
+      - if articles.empty?
+        | 在庫なし
+
+### 出力 `=`
+
+イコールはバッファに追加する出力を生成する Ruby 呼び出しを Slim に命令します。Ruby のコードが複数行にわたる場合, 例のように行末にバックスラッシュを追加します。
+
+    = javascript_include_tag \
+       "jquery",
+       "application"
+
+行末がカンマ `,` で終わる場合 (例 関数呼び出し) には行末にバックスラッシュを追加する必要はありません。行末スペースを追加するために修飾子の `>` や `<` もサポートします。
+
+* `=>` は末尾のスペースを伴った出力をします。 末尾のスペースが追加されることを除いて, 単一の等合 (`=`) と同じです。古い構文の `='` も同様にサポートされます。
+* `=<` は先頭のスペースを伴った出力をします。先頭のスペースが追加されることを除いて, 単一の等号 (`=`) と同じです。
+
+### HTML エスケープを伴わない出力 `==`
+
+単一のイコール (`=`) と同じですが, `escape_html` メソッドを経由しません。 末尾や先頭のスペースを追加するための修飾子 `>` と `<` はサポートされています。
+
+* `==>` は HTML エスケープを行わず末尾のスペースを伴った出力をします。末尾のスペースが追加されることを除いて, 二重等号 (`==`) と同じです。 古い構文の `=='` もサポートされます。
+* `==<` は HTML エスケープを行わず先頭のスペースを伴った出力をします。先頭のスペースが追加されることを除いて, 二重等号 (`==`) と同じです。
+
+### コードコメント `/`
+
+コードコメントにはスラッシュを使います。スラッシュ以降は最終的なレンダリング結果に表示されません。コードコメントには `/` を, html コメントには `/!` を使います。
+
+    body
+      p
+        / この行は表示されません。
+          この行も表示されません。
+        /! html コメントとして表示されます。
+
+  構文解析結果は以下:
+
+    <body><p><!--html コメントとして表示されます。--></p></body>
+
+### HTML コメント `/!`
+
+html コメントにはスラッシュの直後にエクスクラメーションマークを使います (`<!-- ... -->`)。
+
+### IE コンディショナルコメント `/[...]`
+
+    /[if IE]
+        p もっと良いブラウザを使ってください。
+
+レンダリング結果
+
+    <!--[if IE]><p>もっと良いブラウザを使ってください。</p><![endif]-->
+
+## HTML タグ
+
+### ドキュメントタイプタグ
+
+ドキュメントタイプタグはとても簡単な方法で複雑なドキュメントタイプを生成するために使われる特別なタグです。
+
+XML 宣言
+
+    doctype xml
+      <?xml version="1.0" encoding="utf-8" ?>
+
+    doctype xml ISO-8859-1
+      <?xml version="1.0" encoding="iso-8859-1" ?>
+
+XHTML ドキュメントタイプ
+
+    doctype html
+      <!DOCTYPE html>
+
+    doctype 5
+      <!DOCTYPE html>
+
+    doctype 1.1
+      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+        "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+
+    doctype strict
+      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+    doctype frameset
+      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
+
+    doctype mobile
+      <!DOCTYPE html PUBLIC "-//WAPFORUM//DTD XHTML Mobile 1.2//EN"
+        "http://www.openmobilealliance.org/tech/DTD/xhtml-mobile12.dtd">
+
+    doctype basic
+      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN"
+        "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+
+    doctype transitional
+      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+HTML 4 ドキュメントタイプ
+
+    doctype strict
+      <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
+        "http://www.w3.org/TR/html4/strict.dtd">
+
+    doctype frameset
+      <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
+        "http://www.w3.org/TR/html4/frameset.dtd">
+
+    doctype transitional
+      <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+        "http://www.w3.org/TR/html4/loose.dtd">
+
+### 閉じタグ (末尾 `/`)
+
+末尾に `/` を付けることで明示的にタグを閉じることができます。
+
+    img src="image.png"/
+
+(注) 標準的な html タグ (img, br, ...) は自動的にタグを閉じるので,
+通常必要ありません。
+
+### スペースを追加する (`<`, `>`)
+
+a タグの後に > を追加することで末尾にスペースを追加するよう Slim に強制することができます。
+
+    a> href='url1' Link1
+    a> href='url2' Link2
+
+< を追加することで先頭のスペースを追加できます。
+
+    a< href='url1' Link1
+    a< href='url2' Link2
+
+これらを組み合わせて使うこともできます。
+
+    a<> href='url1' Link1
+
+### インラインタグ
+
+時々タグをよりコンパクトにインラインにしたくなるかもしれません。
+
+    ul
+      li.first: a href="/a" A リンク
+      li: a href="/b" B リンク
+
+読みやすくするために, 属性を囲むことができるのを忘れないでください。
+
+    ul
+      li.first: a[href="/a"] A リンク
+      li: a[href="/b"] B リンク
+
+### テキストコンテンツ
+
+タグと同じ行で開始するか
+
+    body
+      h1 id="headline" 私のサイトへようこそ。
+
+入れ子にするのかどちらかです。エスケープ処理を行うためにはパイプかバッククォートを使わなければなりません。
+
+    body
+      h1 id="headline"
+        | 私のサイトへようこそ。
+
+### 動的コンテンツ (`=` と `==`)
+
+同じ行で呼び出すか
+
+    body
+      h1 id="headline" = page_headline
+
+入れ子にすることができます。
+
+    body
+      h1 id="headline"
+        = page_headline
+
+### 属性
+
+タグの後に直接属性を書きます。属性のテキストにはダブルクォート `"` か シングルクォート `'` を使わなければなりません (引用符で囲まれた属性)。
+
+    a href="http://slim-lang.com" title='Slim のホームページ' Slim のホームページへ
+
+引用符で囲まれたテキストを属性として使えます。
+
+#### 属性の囲み
+
+区切り文字が構文を読みやすくするのであれば,
+`{...}`, `(...)`, `[...]` が属性の囲みに使えます。
+これらの記号は設定できます (`:attr_delims` オプション参照)。
+
+    body
+      h1(id="logo") = page_logo
+      h2[id="tagline" class="small tagline"] = page_tagline
+
+属性を囲んだ場合, 属性を複数行にわたって書くことができます:
+
+    h2[id="tagline"
+       class="small tagline"] = page_tagline
+
+属性の囲みや変数まわりにスペースを使うことができます:
+
+    h1 id = "logo" = page_logo
+    h2 [ id = "tagline" ] = page_tagline
+
+#### 引用符で囲まれた属性
+
+例:
+
+    a href="http://slim-lang.com" title='Slim のホームページ' Slim のホームページへ
+
+引用符で囲まれたテキストを属性として使えます:
+
+    a href="http://#{url}" #{url} へ
+
+属性値はデフォルトでエスケープされます。属性のエスケープを無効にしたい場合 == を使います。
+
+    a href=="&amp;"
+
+引用符で囲まれた属性をバックスラッシュ `\` で改行できます。
+
+    a data-title="help" data-content="極めて長い長い長いヘルプテキストで\
+      1つずつ1つずつその後はまたやり直して繰り返し...."
+
+#### Ruby コードを用いた属性
+
+`=` の後に直接 Ruby コードを書きます。コードにスペースが含まれる場合,
+`(...)` の括弧でコードを囲まなければなりません。ハッシュを `{...}` に, 配列を `[...]` に書くこともできます。 
+
+    body
+      table
+        - for user in users
+          td id="user_#{user.id}" class=user.role
+            a href=user_action(user, :edit) Edit #{user.name}
+            a href=(path_to_user user) = user.name
+
+属性値はデフォルトでエスケープされます。属性のエスケープを無効にしたい場合 == を使います。
+
+    a href==action_path(:start)
+
+Ruby コードの属性は, コントロールセクションにあるようにバックスラッシュ `\` や `,` を用いて改行できます。
+
+#### 真偽値属性
+
+属性値の `true`, `false` や `nil` は真偽値として
+評価されます。属性を括弧で囲む場合, 属性値の指定を省略することができます。
+
+    input type="text" disabled="disabled"
+    input type="text" disabled=true
+    input(type="text" disabled)
+
+    input type="text"
+    input type="text" disabled=false
+    input type="text" disabled=nil
+
+#### 属性の結合
+
+複数の属性が与えられた場合に属性をまとめるように設定することができます (`:merge_attrs` 参照)。デフォルト設定では
+ class 属性は空白区切りで結合されます。
+
+    a.menu class="highlight" href="http://slim-lang.com/" Slim-lang.com
+
+レンダリング結果
+
+    <a class="menu highlight" href="http://slim-lang.com/">Slim-lang.com</a>
+
+また, `Array` や配列要素を属性値として区切り文字で結合し使うこともできます。
+
+    a class=["menu","highlight"]
+    a class=:menu,:highlight
+
+#### アスタリスク属性 `*`
+
+アスタリスクによってハッシュを属性/値のペアとして使うことができます。
+
+    .card*{'data-url'=>place_path(place), 'data-id'=>place.id} = place.name
+
+レンダリング結果
+
+    <div class="card" data-id="1234" data-url="/place/1234">Slim の家</div>
+
+次のようにハッシュを返すメソッドやインスタンス変数を使うこともできます"
+
+    .card *method_which_returns_hash = place.name
+    .card *@hash_instance_variable = place.name
+
+属性の結合 (Slim オプション `:merge_attrs` 参照) に対応するハッシュ属性には `Array` を与えることもできます。
+
+    .first *{:class => [:second, :third]} テキスト
+
+レンダリング結果
+
+    div class="first second third"
+
+#### 動的タグ `*`
+
+アスタリスク属性を使用することで完全に動的なタグを作ることができます。:tag をキーにもつハッシュを返すメソッドを
+作るだけです。
+
+    ruby:
+      def a_unless_current
+        @page_current ? {:tag => 'span'} : {:tag => 'a', :href => 'http://slim-lang.com/'}
+      end
+    - @page_current = true
+    *a_unless_current リンク
+    - @page_current = false
+    *a_unless_current リンク
+
+レンダリング結果
+
+    <span>リンク</span><a href="http://slim-lang.com/">リンク</a>
+
+### ショートカット
+
+#### タグショートカット
+
+`:shortcut` オプションを設定することで独自のタグショートカットを定義できます。
+
+    Slim::Engine.set_default_options :shortcut => {'c' => {:tag => 'container'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'} }
+
+Slim コードの中でこの様に使用できます。
+
+    c.content テキスト
+
+レンダリング結果
+
+    <container class="content">テキスト</container>
+
+#### 属性のショートカット
+
+カスタムショートカットを定義することができます (`#` が id で `.` が class であるように)。
+
+例として `&` で作った type 属性付きの input 要素のショートカットを作成し追加します。
+
+    Slim::Engine.set_default_options :shortcut => {'&' => {:tag => 'input', :attr => 'type'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'}}
+
+Slim コードの中でこの様に使用できます。
+
+    &text name="user"
+    &password name="pw"
+    &submit
+
+レンダリング結果
+
+    <input type="text" name="user" />
+    <input type="password" name="pw" />
+    <input type="submit" />
+
+別の例として `@` で作った role 属性のショートカットを作成し追加します。
+
+    Slim::Engine.set_default_options :shortcut => {'@' => 'role', '#' => 'id', '.' => 'class'}
+
+Slim コードの中でこの様に使用できます。
+
+    .person@admin = person.name
+
+レンダリング結果
+
+    <div class="person" role="admin">Daniel</div>
+
+1つのショートカットを使って複数の属性を設定することもできます。
+
+    Slim::Engine.set_default_options :shortcut => {'@' => {:attr => %w(data-role role)}}
+
+Slim の中で次のように使用し
+
+    .person@admin = person.name
+
+このようのレンダリングされます。
+
+    <div class="person" role="admin" data-role="admin">Daniel</div>
+
+#### ID ショートカット `#` と class ショートカット `.`
+
+Haml と同じように, `id` と `class` の属性を次のショートカットで指定できます。
+
+    body
+      h1#headline
+        = page_headline
+      h2#tagline.small.tagline
+        = page_tagline
+      .content
+        = show_content
+
+これは次に同じです
+
+    body
+      h1 id="headline"
+        = page_headline
+      h2 id="tagline" class="small tagline"
+        = page_tagline
+      div class="content"
+        = show_content
+
+## ヘルパ, キャプチャとインクルード
+
+いくつかのヘルパを使用してテンプレートを拡張することもできます。次のヘルパが定義されていることを前提として,
+
+~~~ruby
+module Helpers
+  def headline(&block)
+    if defined?(::Rails)
+      # Rails の場合には capture メソッドを使う
+      "<h1>#{capture(&block)}</h1>"
+    else
+      # フレームワークなしで Slim を使う場合(Tilt の場合), 
+      # ただ出力する
+      "<h1>#{yield}</h1>"
+    end
+  end
+end
+~~~
+
+このインクルードされたコードのスコープは実行される Slim のテンプレートコードです。Slim テンプレートの中では次のように使用することができます。
+
+    p
+      = headline do
+        ' Hello
+        = user.name
+
+`do` ブロック内のコンテンツが自動的にキャプチャされ `yield` を通してヘルパに渡されます。糖衣構文として
+`do` キーワードを省略して書くこともできます。
+
+    p
+      = headline
+        ' Hello
+        = user.name
+
+これまで幾度となく Slim にサブテンプレートのインクルードがリクエストされてきました。今ではコア機能として実装されなくとも
+簡単に独自のヘルパを書いて使用することができます。このインクルードは実行時に行われます。
+
+~~~ruby
+module Helpers
+  def include_slim(name, options = {}, &block)
+    Slim::Template.new("#{name}.slim", options).render(self, &block)
+  end
+end
+~~~
+
+このヘルパは次のように使用できます
+
+    nav= include_slim 'menu'
+    section= include_slim 'content'
+
+しかし, このヘルパはキャッシュを行いません。その為, 目的にあったよりインテリジェントなバージョンを
+実装する必要があります。また, ほとんどのフレームワークにはすでに同様のヘルパが含まれるので注意してください。(例: Rails の `render` メソッド)
+
+## テキストの展開
+
+Ruby の標準的な展開方法を使用します。テキストはデフォルトで html エスケープされます。
+
+    body
+      h1 ようこそ #{current_user.name} ショーへ。
+      | エスケープしない #{{content}} こともできます。
+
+展開したテキストのエスケープ方法 (言い換えればそのままのレンダリング)
+
+    body
+      h1 ようこそ \#{current_user.name} ショーへ。
+
+## 埋め込みエンジン (Markdown, ...)
+
+ありがとう [Tilt](https://github.com/rtomayko/tilt), Slim は他のテンプレートエンジンの埋め込みに見事に対応します。
+
+例:
+
+    coffee:
+      square = (x) -> x * x
+
+    markdown:
+      #Header
+        #{"Markdown"} からこんにちわ!
+        2行目!
+
+対応エンジン:
+
+| フィルタ | 必要な gems | 種類 | 説明 |
+| -------- | ----------- | ---- | ----------- |
+| ruby: | なし | ショートカット | Ruby コードを埋め込むショートカット |
+| javascript: | なし | ショートカット | javascript コードを埋め込むショートカットで script タグで囲む |
+| css: | なし | ショートカット | css コードを埋め込むショートカットで style タグで囲む |
+| sass: | sass | コンパイル時 | sass コードを埋め込むショートカットで style タグで囲む |
+| scss: | sass | コンパイル時 | scss コードを埋め込むショートカットで style タグで囲む |
+| less: | less | コンパイル時 | less コードを埋め込むショートカットで style タグで囲む |
+| styl: | styl | コンパイル時 | stylus コードを埋め込むショートカットで style タグで囲む |
+| coffee: | coffee-script | コンパイル時 | コンパイルした CoffeeScript で script タグで囲む |
+| asciidoc: | asciidoctor | コンパイル時 + 展開 | AsciiDoc コードのコンパイルとテキスト中の # \{variables} の展開 |
+| markdown: | redcarpet/rdiscount/kramdown | コンパイル時 + 展開 | Markdownのコンパイルとテキスト中の # \{variables} の展開 |
+| textile: | redcloth | コンパイル時 + 展開 | textile のコンパイルとテキスト中の # \{variables} の展開 |
+| creole: | creole | コンパイル時 + 展開 | cleole のコンパイルとテキスト中の # \{variables} の展開 |
+| wiki:, mediawiki: | wikicloth | コンパイル時 + 展開 | wiki のコンパイルとテキスト中の # \{variables} の展開 |
+| rdoc: | rdoc | コンパイル時 + 展開 | RDoc のコンパイルとテキスト中の # \{variables} の展開 |
+| builder: | builder | プレコンパイル | builder コードの埋め込み |
+| nokogiri: | nokogiri | プレコンパイル | nokogiri コードの埋め込み |
+| erb: | なし | プレコンパイル | erb コードの埋め込み |
+
+埋め込みエンジンは Slim の `Slim::Embedded` フィルタのオプションで直接設定されます。例:
+
+    Slim::Embedded.default_options[:markdown] = {:auto_ids => false}
+
+## Slim の設定
+
+Slim とその基礎となる [Temple](https://github.com/judofyr/temple) は非常に柔軟に設定可能です。
+Slim を設定する方法はコンパイル機構に少し依存します。(Rails や [Tilt](https://github.com/rtomayko/tilt))。デフォルトオプションの設定は `Slim::Engine` クラスでいつでも可能です。Rails の 環境設定ファイルで設定可能です。例えば, config/environments/developers.rb で設定したいとします:
+
+### デフォルトオプション
+
+    # デバック用に html をきれいにインデントし属性をソートしない (Ruby 1.8)
+    Slim::Engine.set_default_options :pretty => true. :sort_attrs => false
+
+    # デバック用に html をきれいにインデントし属性をソートしない (Ruby 1.9)
+    Slim::Engine.set_default_options pretty: true, sort_attrs: false
+
+ハッシュで直接オプションにアクセスすることもできます:
+
+    Slim::Engine.default_options[:pretty] = true
+
+### 実行時のオプション設定
+
+実行時のオプション設定の方法は2つあります。Tilt テンプレート (`Slim::Template`) の場合, テンプレートを
+インスタンス化する時にオプションを設定できます。
+
+    Slim::Template.new('template.slim', optional_option_hash).render(scope)
+
+他の方法は Rails に主に関係がありますがスレッド毎にオプション設定を行う方法です:
+
+    Slim::Engine.with_options(option_hash) do
+       # ここで作成される Slim エンジンは option_hash を使用します
+       # Rails での使用例:
+       render :page, :layout => true
+    end
+
+Rails ではコンパイルされたテンプレートエンジンのコードとオプションはテンプレート毎にキャッシュされ, 後でオプションを変更できないことに注意する必要があります。
+
+    # 最初のレンダリング呼び出し
+    Slim::Engine.with_options(:pretty => true) do
+       render :page, :layout => true
+    end
+
+    # 2回目のレンダリング呼び出し
+    Slim::Engine.with_options(:pretty => false) do
+       render :page, :layout => true # :pretty is still true because it is cached
+    end
+
+### 可能なオプション
+
+次のオプションが `Slim::Engine` によって用意され `Slim::Engine.set_default_options` で設定することができます。
+沢山ありますが良いことに, Slim はもし誤った設定キーを使用しようとした場合キーをチェックしエラーを報告します。
+
+| 種類 | 名前 | デフォルト | 用途 |
+| ---- | ---- | ---------- | ---- |
+| 文字列 | :file | nil | 解析対象のファイル名ですが,  Slim::Template によって自動的に設定されます |
+| 数値 | :tabsize | 4 | 1 タブあたりのスペース数 (構文解析で利用されます) |
+| 文字列 | :encoding | "utf-8" | テンプレートのエンコーディングを設定 |
+| 文字列 | :default_tag | "div" | タグ名が省略されている場合デフォルトのタグとして使用される |
+| ハッシュ | :shortcut | \{'.' => {:attr => 'class'}, '#' => {:attr => 'id'}} | 属性のショートカット |
+| Hash | :attr_delims | \{'(' => ')', '[' => ']', '{' => '}'} | 属性区切り文字 |
+| 配列&lt;シンボル,文字列&gt; | :enable_engines | nil <i>(すべて可)</i> | 有効な埋め込みエンジンリスト (ホワイトリスト) |
+| 配列&lt;シンボル,文字列&gt; | :disable_engines | nil <i>(無効なし)</i> | 無効な埋め込みエンジンリスト (ブラックリスト) |
+| 真偽値 | :disable_capture | false (Rails では true) | ブロック内キャプチャ無効 (ブロックはデフォルトのバッファに書き込む)  |
+| 真偽値 | :disable_escape | false | 文字列の自動エスケープ無効 |
+| 真偽値 | :use_html_safe | false (Rails では true) | ActiveSupport の String# html_safe? を使う (:disable_escape と一緒に機能する) |
+| シンボル | :format | :xhtml | html の出力フォーマット (対応フォーマット :xhtml, :html4, :html5, :html) |
+| 文字列 | :attr_quote |  '"'  | html の属性を囲む文字 (' または " が可能) |
+| ハッシュ | :merge_attrs | \{'class' => ' '} | 複数の html 属性が与えられた場合結合に使われる文字列 (例: class="class1 class2") |
+| 配列&lt;文字列&gt; | :hyphen_attrs | %w(data) | 属性にハッシュが与えられた場合ハイフンつなぎされます。(例: data={a:1, b:2} は data-a="1" data-b="2" のように) |
+| 真偽値 | :sort_attrs | true | 名前によって属性をソート |
+| シンボル | :js_wrapper | nil | :comment,  :cdata や :both で JavaScript をラップします。:guess を指定することで :format オプションに基いて設定することもできます |
+| 真偽値 | :pretty | false | 綺麗な html インデント <b>(遅くなります!)</b> |
+| 文字列 | :indent | '  ' | インデントに使用される文字列 |
+| 真偽値 | :streaming | false (Rails > 3.1 では true) | ストリーミング出力の有効化 |
+| Class | :generator | Temple::Generators::ArrayBuffer/ RailsOutputBuffer | Temple コードジェネレータ (デフォルトのジェネレータは配列バッファを生成します) |
+| 文字列 | :buffer | '_buf' (Rails では '@output_buffer') | バッファに使用される変数 |
+
+Temple フィルタによってもっと多くのオプションがサポートされていますが一覧には載せず公式にはサポートしません。
+Slim と Temple のコードを確認しなければなりません。
+
+### オプションの優先順位と継承
+
+Slim や Temple のアーキテクチャについてよく知っている開発者は異なる場所で設定を
+上書きすることができます。 Temple はサブクラスがスーパークラスのオプションを上書きできるように
+継承メカニズムを採用しています。オプションの優先順位は次のとおりです:
+
+1. `Slim::Template` オプションはエンジン初期化時に適用されます
+2. `Slim::Template.default_options`
+3. `Slim::Engine.thread_options`, `Slim::Engine.default_options`
+5. パーサ/フィルタ/ジェネレータ `thread_options`, `default_options` (例: `Slim::Parser`, `Slim::Compiler`)
+
+`Temple::Engine` のようにスーパークラスのオプションを設定することも可能です。しかしこれはすべての Temple テンプレートエンジンに影響します。
+
+    Slim::Engine < Temple::Engine
+    Slim::Compiler < Temple::Filter
+
+## プラグイン
+
+Slim はロジックレスモードと I18n プラグインを提供しています。プラグインのドキュメントを確認してください。
+
+* [ロジックレスモード](doc/logic_less.md)
+* [多言語化/I18n](doc/translator.md)
+
+## フレームワークサポート
+
+### Tilt
+
+Slim は生成されたコードをコンパイルするために [Tilt](https://github.com/rtomayko/tilt) を使用します。Slim テンプレートを直接使いたい場合, Tilt インターフェイスが使用できます。
+
+    Tilt.new['template.slim'].render(scope)
+    Slim::Template.new('template.slim', optional_option_hash).render(scope)
+    Slim::Template.new(optional_option_hash) { source }.render(scope)
+
+optional_option_hash は前述のオプションを持つことができます。このオブジェクトのスコープは実行されるテンプレートの
+コードです。
+
+### Sinatra
+
+<pre>require 'sinatra'
+require 'slim'
+
+get('/') { slim :index }
+
+ __END__
+@@ index
+doctype html
+html
+  head
+    title Slim で Sinatra
+  body
+    h1 Slim は楽しい!
+</pre>
+
+### Rails
+
+Rails のジェネレータは [slim-rails](https://github.com/slim-template/slim-rails) によって提供されます。
+slim-rails は Rails で Slim を使用する場合に必須ではありません。Slim をインストールし Gemfile に `gem 'slim'` を追加するだけです。
+後は .slim 拡張子を使えば Rails で使用できます。
+
+#### Streaming
+
+HTTP ストリーミングは Rails がそれをサポートしているバージョンであればデフォルトで有効化されています。
+
+## ツール
+
+### Slim コマンド 'slimrb'
+
+gem の 'slim' にはコマンドラインから Slim をテストするための小さなツール 'slimrb' が付属します。
+
+<pre>
+$ slimrb --help
+Usage: slimrb [options]
+    -s, --stdin                      Read input from standard input instead of an input file
+        --trace                      Show a full traceback on error
+    -c, --compile                    Compile only but do not run
+    -e, --erb                        Convert to ERB
+    -r, --rails                      Generate rails compatible code (Implies --compile)
+    -t, --translator                 Enable translator plugin
+    -l, --logic-less                 Enable logic less plugin
+    -p, --pretty                     Produce pretty html
+    -o, --option [NAME=CODE]         Set slim option
+    -h, --help                       Show this message
+    -v, --version                    Print version
+</pre>
+
+'slimrb' で起動し, コードをタイプし Ctrl-d で EOF を送ります。Windows のコマンドプロンプトでは Ctrl-z で EOF を送ります。使い方例: 
+
+<pre>
+$ slimrb
+markdown:
+  最初の段落。
+
+  2つ目の段落。
+
+  * 1つ
+  * 2つ
+  * 3つ
+
+//Enter Ctrl-d
+&lt;p&gt;最初の段落。 &lt;/p&gt;
+
+&lt;p&gt;2つめの段落。 &lt;/p&gt;
+
+&lt;ul&gt;
+&lt;li&gt;1つ&lt;/li&gt;
+&lt;li&gt;2つ&lt;/li&gt;
+&lt;li&gt;3つ&lt;/li&gt;
+&lt;/ul&gt;
+</pre>
+
+### 構文ハイライト
+
+様々なテキストエディタのためのプラグインがあります。(最も重要なものも含めて - Vim, Emacs や Textmate):
+
+* [Vim](https://github.com/slim-template/vim-slim)
+* [Emacs](https://github.com/slim-template/emacs-slim)
+* [Textmate / Sublime Text](https://github.com/slim-template/ruby-slim.tmbundle)
+* [Espresso text editor](https://github.com/slim-template/Slim-Sugar)
+* [Coda](https://github.com/slim-template/Coda-2-Slim.mode)
+
+### テンプレート変換 (HAML, ERB, ...)
+
+* Slim は gem に含まれる `slimrb` や `Slim::ERBConverter` を用いて ERB に変換できます。
+* [Haml2Slim converter](https://github.com/slim-template/haml2slim)
+* [ERB2Slim, HTML2Slim converter](https://github.com/slim-template/html2slim)
+
+## テスト
+
+### ベンチマーク
+
+  *そうです, Slim は最速の Ruby のテンプレートエンジンです!
+   production モードの Slim は Erubis (最速のテンプレートエンジン) と同じくらい高速です。
+   ありがたいことに何らかの理由であなたが Slim を選択した場合, 私たちは
+   パフォーマンスが障害にならないだろうことを保証します。*
+
+ベンチマークは `rake bench` で実行します。時間が余計にかかりますが遅い解析ベンチマークを
+実行したい場合 `slow` オプションを追加できます。
+
+    rake bench slow=1 iterations=1000
+
+私たちはコミット毎に Travis-CI でベンチマークをとっています。最新のベンチマーク結果はリンク先を確認: <http://travis-ci.org/slim-template/slim>
+
+### テストスイートと継続的インテグレーション
+
+Slim は minitest ベースの拡張性のあるテストスイートを提供します。テストは 'rake test' または
+rails のインテグレーションテストの場合 'rake test:rails' で実行できます。
+
+私たちは現在 markdown ファイルで書かれた人間が読めるテストを試しています: [TESTS.md](test/literate/TESTS.md)
+
+Travis-CI は継続的インテグレーションテストに利用されています: <http://travis-ci.org/slim-template/slim>
+
+Slim はすべての主要な Ruby 実装で動作します:
+
+* Ruby 1.8.7, 1.9.3 および 2.0.0
+* Ruby EE
+* JRuby
+* Rubinius 2.0
+
+## 貢献
+
+Slim の改良を支援したい場合, Git で管理されているプロジェクトを clone してください。
+
+    $ git clone git://github.com/slim-template/slim
+
+魔法をかけた後 pull request を送ってください。私たちは pull request が大好きです！
+
+Ruby の 2.0.0, 1.9.3 と 1.8.7 でテストをすることを覚えておいてください。
+
+もしドキュメントの不足を見つけたら, README.md をアップデートして私たちを助けて下さい。Slim に割く時間がないが, 私たちが知るべきものを何か見つけた場合には issue を送ってください。
+
+## License
+
+Slim は [MIT license](http://www.opensource.org/licenses/MIT) に基づいてリリースされています。
+
+## 作者
+
+* [Daniel Mendler](https://github.com/minad) (Lead developer)
+* [Andrew Stone](https://github.com/stonean)
+* [Fred Wu](https://github.com/fredwu)
+
+## 寄付とサポート
+
+このプロジェクトをサポートしたい場合, Gittip や Flattr のページを見てください。
+
+[![Gittip donate button](http://img.shields.io/gittip/bevry.png)](https://www.gittip.com/min4d/ "Donate weekly to this project using Gittip")
+[![Flattr donate button](https://raw.github.com/balupton/flattr-buttons/master/badge-89x18.gif)](https://flattr.com/submit/auto?user_id=min4d&url=http%3A%2F%2Fslim-lang.org%2F "Donate monthly to this project using Flattr")
+
+今のところ, 寄付はホスティング費用 (ドメインなど) に当てられる予定です。
+
+## 議論
+
+* [Google Group](http://groups.google.com/group/slim-template)
+
+## 関連プロジェクト
+
+テンプレートのコンパイルフレームワーク:
+
+* [Temple](https://github.com/judofyr/temple)
+
+フレームワークサポート:
+
+* [Rails generators (slim-rails)](https://github.com/slim-template/slim-rails)
+
+構文ハイライト:
+
+* [Vim](https://github.com/slim-template/vim-slim)
+* [Emacs](https://github.com/slim-template/emacs-slim)
+* [Textmate / Sublime Text](https://github.com/slim-template/ruby-slim.tmbundle)
+* [Espresso text editor](https://github.com/slim-template/Slim-Sugar)
+* [Coda](https://github.com/slim-template/Coda-2-Slim.mode)
+* [Atom](https://github.com/slim-template/language-slim)
+
+テンプレート変換 (HAML, ERB, ...):
+
+* [Haml2Slim converter](https://github.com/slim-template/haml2slim)
+* [ERB2Slim, HTML2Slim converter](https://github.com/slim-template/html2slim)
+
+移植言語/同様の言語:
+
+* [Coffee script plugin for Slim](https://github.com/yury/coffee-views)
+* [Clojure port of Slim](https://github.com/chaslemley/slim.clj)
+* [Hamlet.rb (Similar template language)](https://github.com/gregwebs/hamlet.rb)
+* [Plim (Python port of Slim)](https://github.com/2nd/plim)
+* [Skim (Slim for Javascript)](https://github.com/jfirebaugh/skim)
+* [Emblem.js (Javascript, similar to Slim)](https://github.com/machty/emblem.js)
+* [Haml (Older engine which inspired Slim)](https://github.com/haml/haml)
+* [Jade (Similar engine for javascript)](https://github.com/visionmedia/jade)
+* [Sweet (Similar engine which also allows to write classes and functions)](https://github.com/joaomdmoura/sweet)