RubyGems - slim - Versions diffs - 2.0.3 → 2.1.0 - Mend

slim 2.0.3 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (54) hide show

checksums.yaml +4 -4
data/.travis.yml +7 -8
data/.yardopts +1 -1
data/CHANGES +23 -0
data/Gemfile +2 -1
data/LICENSE +1 -1
data/README.jp.md +497 -268
data/README.md +505 -278
data/Rakefile +14 -2
data/benchmarks/view.haml +2 -2
data/doc/include.md +20 -0
data/doc/jp/include.md +20 -0
data/doc/jp/logic_less.md +137 -0
data/doc/jp/smart.md +102 -0
data/doc/jp/translator.md +28 -0
data/doc/smart.md +102 -0
data/lib/slim/command.rb +8 -2
data/lib/slim/controls.rb +4 -3
data/lib/slim/do_inserter.rb +1 -1
data/lib/slim/embedded.rb +26 -22
data/lib/slim/end_inserter.rb +1 -1
data/lib/slim/engine.rb +3 -2
data/lib/slim/filter.rb +2 -2
data/lib/slim/grammar.rb +3 -1
data/lib/slim/include.rb +54 -0
data/lib/slim/interpolation.rb +1 -1
data/lib/slim/parser.rb +61 -46
data/lib/slim/smart.rb +8 -0
data/lib/slim/smart/escaper.rb +42 -0
data/lib/slim/smart/filter.rb +96 -0
data/lib/slim/smart/parser.rb +33 -0
data/lib/slim/splat/builder.rb +3 -3
data/lib/slim/splat/filter.rb +2 -2
data/lib/slim/translator.rb +2 -2
data/lib/slim/version.rb +1 -1
data/slim.gemspec +1 -1
data/test/core/helper.rb +5 -3
data/test/core/test_code_blocks.rb +11 -0
data/test/core/test_code_escaping.rb +14 -4
data/test/core/test_embedded_engines.rb +26 -0
data/test/core/test_html_structure.rb +39 -0
data/test/core/test_parser_errors.rb +8 -25
data/test/core/test_pretty.rb +15 -0
data/test/core/test_ruby_errors.rb +0 -10
data/test/include/files/recursive.slim +1 -0
data/test/include/files/slimfile.slim +3 -0
data/test/include/files/subdir/test.slim +1 -0
data/test/include/files/textfile +1 -0
data/test/include/test_include.rb +23 -0
data/test/literate/TESTS.md +17 -2
data/test/rails/test/test_slim.rb +1 -1
data/test/smart/test_smart_text.rb +300 -0
data/test/translator/test_translator.rb +7 -6
metadata +22 -4

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 58912f8464de3ff74107a9ded1bf191b976cb7b3
-  data.tar.gz: aaf442c2a361a88e18dea6622e79cd9184369ab8
+  metadata.gz: c3e6e5e0191a26434040102229ea08970f481344
+  data.tar.gz: 4b8485efd9294318590d5472336ed7f6aef1f319
 SHA512:
-  metadata.gz: 9c6b789d0f7d192a1edc2461a03cba9fde694498893514c51f91db6f21f1941f72c7ddc6ca2cd562bb013b2d217488b1264d1236956f44be7ec3c50c5802f012
-  data.tar.gz: 1975be4161db643822c4e3c3269725d32cc94d4e692b217d71cf69af0f82e1982dbf0ab0720763094799a8f9c3f1683dda0d41c0e98b083971a35e914d46d777
+  metadata.gz: 4dc486456eb27e9a02ce53ea211490222e9cc04f8c13ee4204688dcaceed5a3618c06815ba409863437138e30e73d0c6dcd53838998026b37fa314fad7c52362
+  data.tar.gz: 4768df1dd287abaf00154fb0346fba824602642956dd4116084069398a7a584ee6b352dc906f82c1f0ab825c8678c1579afd490b076248c119044e79ad31cfd6

data/.travis.yml CHANGED

@@ -5,7 +5,6 @@ rvm:
   - 2.0.0
   - 2.1.0
   - ruby-head
-  - jruby-18mode
   - jruby-19mode
   - rbx-2
 env:
@@ -16,9 +15,9 @@ env:
   - "TASK=test:rails RAILS=master"
   - "TASK=test:rails RAILS=3.0.20"
   - "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:rails RAILS=3.2.19 TILT=1.3.4"
+  - "TASK=test:rails RAILS=4.0.9"
+  - "TASK=test:rails RAILS=4.1.5"
   - "TASK=test:sinatra SINATRA=master"
   - "TASK=test:sinatra SINATRA=1.3.6"
   - "TASK=test:sinatra SINATRA=1.4.5"
@@ -34,13 +33,13 @@ matrix:
     - rvm: rbx-2
       env: "TASK=test:rails RAILS=master"
     - rvm: 1.8.7
-      env: "TASK=test:rails RAILS=4.0.4"
+      env: "TASK=test:rails RAILS=4.0.9"
     - rvm: 1.8.7
-      env: "TASK=test:rails RAILS=4.1.0"
+      env: "TASK=test:rails RAILS=4.1.5"
     - rvm: jruby-18mode
-      env: "TASK=test:rails RAILS=4.0.4"
+      env: "TASK=test:rails RAILS=4.0.9"
     - rvm: jruby-18mode
-      env: "TASK=test:rails RAILS=4.1.0"
+      env: "TASK=test:rails RAILS=4.1.5"
   allow_failures:
     - env: "TASK=test:core_and_plugins TILT=master"
     - env: "TASK=test:rails RAILS=master"

data/.yardopts CHANGED

@@ -1,4 +1,4 @@
 --markup-provider redcarpet
 --markup markdown
-- README.md CHANGES LICENSE test/literate/TESTS.md doc/logic_less.md  doc/translator.md
+- README.md CHANGES LICENSE test/literate/TESTS.md doc/logic_less.md  doc/translator.md doc/smart.md

data/CHANGES CHANGED

@@ -1,3 +1,26 @@
+2.1.0
+  * Parser: Require pairwise braces in quoted attributes
+  * Parser: add :attr_list_delims and :code_attr_delims
+  * Parser: deprecate :attr_delims
+  * Parser: relax text indentation requirements:
+    | line
+     next line
+    tag some text
+      more text
+  * Parser: allow first line to be indented
+  * Parser: allow inline embedded languages:
+    .content: markdown: This is **important**
+  * Parser: allow line breaks in quoted attributes
+  * Added Opal as embedded engine
+  * slimrb: Change meaning of -r, deprecate -t and -l
+  * Fix issue with inserted end (#485)
+  * Add experimental 'slim/include' plugin (Might change in the future)
+  * Add experimental 'slim/smart' plugin (Might change in the future)
+  * Drop jruby18 support
+  * Fix rails error reporting #587 (Manipulate stacktrace)
+  * Splat: handle html_safe
 2.0.3
   * slimrb: Don't update HTML output on exceptions

data/Gemfile CHANGED

@@ -10,6 +10,7 @@ end
 if ENV['TILT']
   if ENV['TILT'] == 'master'
+    gem 'opal', :github => 'opal/opal' if RUBY_VERSION > '1.9'
     gem 'tilt', :github => 'rtomayko/tilt'
   else
     gem 'tilt', "= #{ENV['TILT']}"
@@ -51,4 +52,4 @@ gem 'org-ruby'
 if ENV['TASK'] == 'bench'
   gem 'erubis'
   gem 'haml'
-end
+end

data/LICENSE CHANGED

@@ -1,6 +1,6 @@
 The MIT License
-Copyright (c) 2010 - 2013 Slim Team
+Copyright (c) 2010 - 2014 Slim Team
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.jp.md CHANGED

@@ -14,9 +14,11 @@ Slim は 不可解にならないように view の構文を本質的な部品
 * 安全性
     * デフォルトで自動 HTML エスケープ
     * Rails の `html_safe?` に対応
-* プラグインを用いた柔軟な設定と拡張性
-    * Mustache のようなロジックレスモードをプラグインで実現
-    * 多言語化/I18n をプラグインで実現
+* 柔軟な設定
+* プラグインを用いた拡張性:
+    * Mustache と同様のロジックレスモード
+    * インクルード
+    * 多言語化/I18n
 * 高性能
     * ERB/Erubis に匹敵するスピード
     * Rails のストリーミングに対応
@@ -26,6 +28,7 @@ Slim は 不可解にならないように view の構文を本質的な部品
 ## リンク
+* ホームページ: <http://slim-lang.com>
 * ソース: <http://github.com/slim-template/slim>
 * バグ:   <http://github.com/slim-template/slim/issues>
 * リスト:   <http://groups.google.com/group/slim-template>
@@ -47,24 +50,27 @@ Slim の核となる構文は1つの考えによって導かれます: "この
 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 が提供する翻訳プラグインに
-使用されます。
+使用されます。ロジックレスモードでは HTML をビルドするために Slim の構文を使いたいが, テンプレートの中で Ruby を書きたくない場合にも Slim を使うことができます。
 ### なぜ Slim を使うのか?
-Rails コミュニティの中で, _Erb_ と _Haml_ は間違いなく最も人気がある2つのテンプレートエンジンです。しかしながら, _Erb_ の構文は扱いにくく, _Haml_ の構文は初心者にはとても謎めいている場合があります。
+* Slim によって メンテナンスが容易な限りなく最小限のテンプレートを作成でき, 正しい文法の HTML や XML が書けることを保証します。
+* Slim の構文は美的であり, テンプレートを書くのを楽しくしてくれると思います。Slim は主要なフレームワークで互換性があるので簡単に始めることができます。
+* Slim のアーキテクチャは非常に柔軟なので構文の拡張やプラグインを書くことができます。
-ロジックレスエンジンのいくつかの発展もあります (例: 標準のHTMLを書かなければいけない [Mustache](https://github.com/defunkt/mustache))。あなたの好みで Slim の構文で HTML をビルドすることができます。Slim の構文で HTML をビルドすることが好きだけどテンプレートに Ruby のコードを書きたくない場合でも Slim のロジックレスモードを使うことができます。
-Slim は 最小限の構文とスピードをもたらすために生まれました。 もし Slim を選択しない場合, その理由はスピード以外の理由によるものでしょう。
-___そう, Slim は速い!___ ベンチマークはコミット毎に <http://travis-ci.org/slim-template/slim> で取られています。
+___そう, Slim は速い!___ Slim は開発当初からパフォーマンスに注意して開発されました。
+ベンチマークはコミット毎に <http://travis-ci.org/slim-template/slim> で取られています。
 この数字が信じられませんか? それは仕方ないことです。是非 rake タスクを使って自分でベンチマークを取ってみてください!
+私たちの考えでは, あなたは Slim の機能と構文を使うべきです。Slim はあなたのアプリケーションのパフォーマンスに悪影響を与えないことを保証します。
 ### どう始めるの?
 Slim を gem としてインストール:
-    gem install slim
+~~~
+gem install slim
+~~~
 あなたの Gemfile に `gem 'slim'` と書いてインクルードするか, ファイルに `require 'slim'` と書く必要があります。これだけです! 後は拡張子に .slim を使うだけで準備はできています。
@@ -72,37 +78,39 @@ Slim を gem としてインストール:
 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}
+~~~ 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つのインデントが必要なだけです。
@@ -113,29 +121,37 @@ Slim テンプレートがどのようなものか簡単な例を示します:
 パイプは Slim に行をコピーしろと命じます。基本的にどのような処理でもエスケープします。
 パイプよりも深くインデントされた各行がコピーされます。
-    body
-      p
-        |
-          これはテキストブロックのテストです。
+~~~ slim
+body
+  p
+    |
+      これはテキストブロックのテストです。
+~~~
   構文解析結果は以下:
-    <body><p>これはテキストブロックのテストです。</p></body>
+~~~ html
+<body><p>これはテキストブロックのテストです。</p></body>
+~~~
   ブロックの左端はパイプ +1 スペースのインデントに設定されています。
   追加のスペースはコピーされます。
-    body
-      p
-        | この行は左端になります。
-            この行はスペース1つを持つことになります。
-              この行はスペース2つを持つことになります。
-                以下同様に...
+~~~ slim
+body
+  p
+    | この行は左端になります。
+       この行はスペース 1 つを持つことになります。
+         この行はスペース 2 つを持つことになります。
+           以下同様に...
+~~~
 テキスト行に HTML を埋め込むこともできます。
-    - articles.each do |a|
-      | <tr><td>#{a.name}</td><td>#{a.description}</td></tr>
+~~~ slim
+- articles.each do |a|
+  | <tr><td>#{a.name}</td><td>#{a.description}</td></tr>
+~~~
 ### テキスト行のスペースをたどる `'`
@@ -144,35 +160,42 @@ 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>
+~~~ slim
+<html>
+  head
+    title Example
+  <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?
-        | 在庫なし
+~~~ slim
+body
+  - if articles.empty?
+    | 在庫なし
+~~~
 ### 出力 `=`
 イコールはバッファに追加する出力を生成する Ruby 呼び出しを Slim に命令します。Ruby のコードが複数行にわたる場合, 例のように行末にバックスラッシュを追加します。
-    = javascript_include_tag \
-       "jquery",
-       "application"
+~~~ slim
+= javascript_include_tag \
+   "jquery",
+   "application"
+~~~
 行末がカンマ `,` で終わる場合 (例 関数呼び出し) には行末にバックスラッシュを追加する必要はありません。行末スペースを追加するために修飾子の `>` や `<` もサポートします。
@@ -190,15 +213,19 @@ Slim テンプレートがどのようなものか簡単な例を示します:
 コードコメントにはスラッシュを使います。スラッシュ以降は最終的なレンダリング結果に表示されません。コードコメントには `/` を, html コメントには `/!` を使います。
-    body
-      p
-        / この行は表示されません。
-          この行も表示されません。
-        /! html コメントとして表示されます。
+~~~ slim
+body
+  p
+    / この行は表示されません。
+      この行も表示されません。
+    /! html コメントとして表示されます。
+~~~
   構文解析結果は以下:
-    <body><p><!--html コメントとして表示されます。--></p></body>
+~~~ html
+<body><p><!--html コメントとして表示されます。--></p></body>
+~~~
 ### HTML コメント `/!`
@@ -206,12 +233,16 @@ html コメントにはスラッシュの直後にエクスクラメーション
 ### IE コンディショナルコメント `/[...]`
-    /[if IE]
-        p もっと良いブラウザを使ってください。
+~~~ slim
+/[if IE]
+    p もっといいブラウザを使ってください。
+~~~
 レンダリング結果
-    <!--[if IE]><p>もっと良いブラウザを使ってください。</p><![endif]-->
+~~~ html
+<!--[if IE]><p>もっといいブラウザを使ってください。</p><![endif]-->
+~~~
 ## HTML タグ
@@ -221,63 +252,71 @@ html コメントにはスラッシュの直後にエクスクラメーション
 XML 宣言
-    doctype xml
-      <?xml version="1.0" encoding="utf-8" ?>
+~~~ slim
+doctype xml
+  <?xml version="1.0" encoding="utf-8" ?>
-    doctype xml ISO-8859-1
-      <?xml version="1.0" encoding="iso-8859-1" ?>
+doctype xml ISO-8859-1
+  <?xml version="1.0" encoding="iso-8859-1" ?>
+~~~
 XHTML ドキュメントタイプ
-    doctype html
-      <!DOCTYPE html>
+~~~ slim
+doctype html
+  <!DOCTYPE html>
-    doctype 5
-      <!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 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 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 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 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 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">
+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">
+~~~ slim
+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 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">
+doctype transitional
+  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+    "http://www.w3.org/TR/html4/loose.dtd">
+~~~
 ### 閉じタグ (末尾 `/`)
 末尾に `/` を付けることで明示的にタグを閉じることができます。
-    img src="image.png"/
+~~~ slim
+img src="image.png"/
+~~~
 (注) 標準的な html タグ (img, br, ...) は自動的にタグを閉じるので,
 通常必要ありません。
@@ -286,63 +325,92 @@ HTML 4 ドキュメントタイプ
 a タグの後に > を追加することで末尾にスペースを追加するよう Slim に強制することができます。
-    a> href='url1' Link1
-    a> href='url2' Link2
+~~~ slim
+a> href='url1' リンク1
+a> href='url2' リンク2
+~~~
 < を追加することで先頭のスペースを追加できます。
-    a< href='url1' Link1
-    a< href='url2' Link2
+~~~ slim
+a< href='url1' リンク1
+a< href='url2' リンク2
+~~~
 これらを組み合わせて使うこともできます。
-    a<> href='url1' Link1
+~~~ slim
+a<> href='url1' リンク1
+~~~
 ### インラインタグ
 時々タグをよりコンパクトにインラインにしたくなるかもしれません。
-    ul
-      li.first: a href="/a" A リンク
-      li: a href="/b" B リンク
+~~~ slim
+ul
+  li.first: a href="/a" A リンク
+  li: a href="/b" B リンク
+~~~
 読みやすくするために, 属性を囲むことができるのを忘れないでください。
-    ul
-      li.first: a[href="/a"] A リンク
-      li: a[href="/b"] B リンク
+~~~ slim
+ul
+  li.first: a[href="/a"] A リンク
+  li: a[href="/b"] B リンク
+~~~
 ### テキストコンテンツ
 タグと同じ行で開始するか
-    body
-      h1 id="headline" 私のサイトへようこそ。
+~~~ slim
+body
+  h1 id="headline" 私のサイトへようこそ。
+~~~
 入れ子にするのかどちらかです。エスケープ処理を行うためにはパイプかバッククォートを使わなければなりません。
-    body
-      h1 id="headline"
-        | 私のサイトへようこそ。
+~~~ slim
+body
+  h1 id="headline"
+    | 私のサイトへようこそ。
+~~~
+スマートテキストモードを有効化して利用する場合
+~~~ slim
+body
+  h1 id="headline"
+    私のサイトへようこそ。
+~~~
 ### 動的コンテンツ (`=` と `==`)
 同じ行で呼び出すか
-    body
-      h1 id="headline" = page_headline
+~~~ slim
+body
+  h1 id="headline" = page_headline
+~~~
 入れ子にすることができます。
-    body
-      h1 id="headline"
-        = page_headline
+~~~ slim
+body
+  h1 id="headline"
+    = page_headline
+~~~
 ### 属性
 タグの後に直接属性を書きます。属性のテキストにはダブルクォート `"` か シングルクォート `'` を使わなければなりません (引用符で囲まれた属性)。
-    a href="http://slim-lang.com" title='Slim のホームページ' Slim のホームページへ
+~~~ slim
+a href="http://slim-lang.com" title='Slim のホームページ' Slim のホームページへ
+~~~
 引用符で囲まれたテキストを属性として使えます。
@@ -350,56 +418,74 @@ a タグの後に > を追加することで末尾にスペースを追加する
 区切り文字が構文を読みやすくするのであれば,
 `{...}`, `(...)`, `[...]` が属性の囲みに使えます。
-これらの記号は設定できます (`:attr_delims` オプション参照)。
+これらの記号は設定できます (`:attr_list_delims` オプション参照)。
-    body
-      h1(id="logo") = page_logo
-      h2[id="tagline" class="small tagline"] = page_tagline
+~~~ slim
+body
+  h1(id="logo") = page_logo
+  h2[id="tagline" class="small tagline"] = page_tagline
+~~~
 属性を囲んだ場合, 属性を複数行にわたって書くことができます:
-    h2[id="tagline"
-       class="small tagline"] = page_tagline
+~~~ slim
+h2[id="tagline"
+   class="small tagline"] = page_tagline
+~~~
 属性の囲みや変数まわりにスペースを使うことができます:
-    h1 id = "logo" = page_logo
-    h2 [ id = "tagline" ] = page_tagline
+~~~ slim
+h1 id = "logo" = page_logo
+h2 [ id = "tagline" ] = page_tagline
+~~~
 #### 引用符で囲まれた属性
 例:
-    a href="http://slim-lang.com" title='Slim のホームページ' Slim のホームページへ
+~~~ slim
+a href="http://slim-lang.com" title='Slim のホームページ' Slim のホームページへ
+~~~
 引用符で囲まれたテキストを属性として使えます:
-    a href="http://#{url}" #{url} へ
+~~~ slim
+a href="http://#{url}" #{url} へ
+~~~
 属性値はデフォルトでエスケープされます。属性のエスケープを無効にしたい場合 == を使います。
-    a href=="&amp;"
+~~~ slim
+a href=="&amp;"
+~~~
 引用符で囲まれた属性をバックスラッシュ `\` で改行できます。
-    a data-title="help" data-content="極めて長い長い長いヘルプテキストで\
-      1つずつ1つずつその後はまたやり直して繰り返し...."
+~~~ slim
+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
+~~~ slim
+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)
+~~~ slim
+a href==action_path(:start)
+~~~
 Ruby コードの属性は, コントロールセクションにあるようにバックスラッシュ `\` や `,` を用いて改行できます。
@@ -408,70 +494,92 @@ Ruby コードの属性は, コントロールセクションにあるように
 属性値の `true`, `false` や `nil` は真偽値として
 評価されます。属性を括弧で囲む場合, 属性値の指定を省略することができます。
-    input type="text" disabled="disabled"
-    input type="text" disabled=true
-    input(type="text" disabled)
+~~~ slim
+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
+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
+~~~ slim
+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>
+~~~ html
+<a class="menu highlight" href="http://slim-lang.com/">Slim-lang.com</a>
+~~~
 また, `Array` や配列要素を属性値として区切り文字で結合し使うこともできます。
-    a class=["menu","highlight"]
-    a class=:menu,:highlight
+~~~ slim
+a class=["menu","highlight"]
+a class=:menu,:highlight
+~~~
 #### アスタリスク属性 `*`
 アスタリスクによってハッシュを属性/値のペアとして使うことができます。
-    .card*{'data-url'=>place_path(place), 'data-id'=>place.id} = place.name
+~~~ slim
+.card*{'data-url'=>place_path(place), 'data-id'=>place.id} = place.name
+~~~
 レンダリング結果
-    <div class="card" data-id="1234" data-url="/place/1234">Slim の家</div>
+~~~ html
+<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
+.card *method_which_returns_hash = place.name
+.card *@hash_instance_variable = place.name
+~~~
 属性の結合 (Slim オプション `:merge_attrs` 参照) に対応するハッシュ属性には `Array` を与えることもできます。
-    .first *{:class => [:second, :third]} テキスト
+~~~ slim
+.first *{:class => [:second, :third]} テキスト
+~~~
 レンダリング結果
-    div class="first second third"
+~~~ slim
+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 リンク
+~~~ slim
+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>
+~~~ html
+<span>リンク</span><a href="http://slim-lang.com/">リンク</a>
+~~~
 ### ショートカット
@@ -479,15 +587,21 @@ Ruby コードの属性は, コントロールセクションにあるように
 `:shortcut` オプションを設定することで独自のタグショートカットを定義できます。
-    Slim::Engine.set_default_options :shortcut => {'c' => {:tag => 'container'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'} }
+~~~ ruby
+Slim::Engine.set_default_options :shortcut => {'c' => {:tag => 'container'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'} }
+~~~
 Slim コードの中でこの様に使用できます。
-    c.content テキスト
+~~~ slim
+c.content テキスト
+~~~
 レンダリング結果
-    <container class="content">テキスト</container>
+~~~ html
+<container class="content">テキスト</container>
+~~~
 #### 属性のショートカット
@@ -495,65 +609,87 @@ Slim コードの中でこの様に使用できます。
 例として `&` で作った type 属性付きの input 要素のショートカットを作成し追加します。
-    Slim::Engine.set_default_options :shortcut => {'&' => {:tag => 'input', :attr => 'type'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'}}
+~~~ ruby
+Slim::Engine.set_default_options :shortcut => {'&' => {:tag => 'input', :attr => 'type'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'}}
+~~~
 Slim コードの中でこの様に使用できます。
-    &text name="user"
-    &password name="pw"
-    &submit
+~~~ slim
+&text name="user"
+&password name="pw"
+&submit
+~~~
 レンダリング結果
-    <input type="text" name="user" />
-    <input type="password" name="pw" />
-    <input type="submit" />
+~~~ html
+<input type="text" name="user" />
+<input type="password" name="pw" />
+<input type="submit" />
+~~~
 別の例として `@` で作った role 属性のショートカットを作成し追加します。
-    Slim::Engine.set_default_options :shortcut => {'@' => 'role', '#' => 'id', '.' => 'class'}
+~~~ ruby
+Slim::Engine.set_default_options :shortcut => {'@' => 'role', '#' => 'id', '.' => 'class'}
+~~~
 Slim コードの中でこの様に使用できます。
-    .person@admin = person.name
+~~~ slim
+.person@admin = person.name
+~~~
 レンダリング結果
-    <div class="person" role="admin">Daniel</div>
+~~~ html
+<div class="person" role="admin">Daniel</div>
+~~~
 1つのショートカットを使って複数の属性を設定することもできます。
-    Slim::Engine.set_default_options :shortcut => {'@' => {:attr => %w(data-role role)}}
+~~~ ruby
+Slim::Engine.set_default_options :shortcut => {'@' => {:attr => %w(data-role role)}}
+~~~
 Slim の中で次のように使用し
-    .person@admin = person.name
+~~~ slim
+.person@admin = person.name
+~~~
 このようのレンダリングされます。
-    <div class="person" role="admin" data-role="admin">Daniel</div>
+~~~ html
+<div class="person" role="admin" data-role="admin">Daniel</div>
+~~~
 #### ID ショートカット `#` と class ショートカット `.`
-Haml と同じように, `id` と `class` の属性を次のショートカットで指定できます。
+`id` と `class` の属性を次のショートカットで指定できます。
-    body
-      h1#headline
-        = page_headline
-      h2#tagline.small.tagline
-        = page_tagline
-      .content
-        = show_content
+~~~ slim
+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
+~~~ slim
+body
+  h1 id="headline"
+    = page_headline
+  h2 id="tagline" class="small tagline"
+    = page_tagline
+  div class="content"
+    = show_content
+~~~
 ## ヘルパ, キャプチャとインクルード
@@ -576,23 +712,76 @@ end
 このインクルードされたコードのスコープは実行される Slim のテンプレートコードです。Slim テンプレートの中では次のように使用することができます。
-    p
-      = headline do
-        ' Hello
-        = user.name
+~~~ slim
+p
+  = headline do
+    ' Hello
+    = user.name
+~~~
 `do` ブロック内のコンテンツが自動的にキャプチャされ `yield` を通してヘルパに渡されます。糖衣構文として
 `do` キーワードを省略して書くこともできます。
-    p
-      = headline
-        ' Hello
-        = user.name
+~~~ slim
+p
+  = headline
+    ' Hello
+    = user.name
+~~~
+### ローカル変数のキャプチャ
-これまで幾度となく Slim にサブテンプレートのインクルードがリクエストされてきました。今ではコア機能として実装されなくとも
-簡単に独自のヘルパを書いて使用することができます。このインクルードは実行時に行われます。
+次のように `Binding` を使ってローカル変数をキャプチャすることができます:
 ~~~ruby
+module Helpers
+  def capture_to_local(var, &block)
+    set_var = block.binding.eval("lambda {|x| #{var} = x }")
+    # Rails では capture! を使います
+    # Slim をフレームワークなしで使う場合 (Tilt のみを使う場合),
+    # キャプチャブロックを取得するには yield が利用できます
+    set_var.call(defined?(::Rails) ? capture(&block) : yield)
+  end
+end
+~~~
+このヘルパは次のように使用できます
+~~~ slim
+/ captured_content 変数は Binding 前に定義されていなければいけません。
+= capture_to_local captured_content=:captured_content
+  p この段落は captured_content 変数にキャプチャされます
+= captured_content
+~~~
+Another interesting use case is to use an enumerable and capture for each element. The helper could look like this
+~~~ ruby
+module Capture
+  def capture(var, enumerable = nil, &block)
+    value = enumerable ? enumerable.map(&block) : yield
+    block.binding.eval("lambda {|x| #{var} = x }").call(value)
+    nil
+  end
+end
+~~~
+and it would be used as follows
+~~~ slim
+- links = { 'http://slim-lang.com' => 'The Slim Template Language' }
+= capture link_list=:link_list, links do |url, text|
+  a href=url = text
+~~~
+Afterwards, `link_list` contains the captured content.
+###　インクルードヘルパ
+コンパイル時にインクルード機能を使いたい場合には, [パーシャルのインクルード](doc/jp/include.md) を見てください。
+実行時にサブテンプレートを実行すること ( Rails の `#render` のように) もできます。インクルードヘルパを自分で用意する必要があります:
+~~~ ruby
 module Helpers
   def include_slim(name, options = {}, &block)
     Slim::Template.new("#{name}.slim", options).render(self, &block)
@@ -602,8 +791,10 @@ end
 このヘルパは次のように使用できます
-    nav= include_slim 'menu'
-    section= include_slim 'content'
+~~~ slim
+nav= include_slim 'menu'
+section= include_slim 'content'
+~~~
 しかし, このヘルパはキャッシュを行いません。その為, 目的にあったよりインテリジェントなバージョンを
 実装する必要があります。また, ほとんどのフレームワークにはすでに同様のヘルパが含まれるので注意してください。(例: Rails の `render` メソッド)
@@ -612,14 +803,18 @@ end
 Ruby の標準的な展開方法を使用します。テキストはデフォルトで html エスケープされます。
-    body
-      h1 ようこそ #{current_user.name} ショーへ。
-      | エスケープしない #{{content}} こともできます。
+~~~ slim
+body
+  h1 ようこそ #{current_user.name} ショーへ。
+  | エスケープしない #{{content}} こともできます。
+~~~
 展開したテキストのエスケープ方法 (言い換えればそのままのレンダリング)
-    body
-      h1 ようこそ \#{current_user.name} ショーへ。
+~~~ slim
+body
+  h1 ようこそ \#{current_user.name} ショーへ。
+~~~
 ## 埋め込みエンジン (Markdown, ...)
@@ -627,6 +822,7 @@ Ruby の標準的な展開方法を使用します。テキストはデフォル
 例:
+~~~ slim
     coffee:
       square = (x) -> x * x
@@ -635,6 +831,9 @@ Ruby の標準的な展開方法を使用します。テキストはデフォル
         #{"Markdown"} からこんにちわ!
         2行目!
+p: markdown: Tag with **inline** markdown!
+~~~
 対応エンジン:
 | フィルタ | 必要な gems | 種類 | 説明 |
@@ -659,7 +858,9 @@ Ruby の標準的な展開方法を使用します。テキストはデフォル
 埋め込みエンジンは Slim の `Slim::Embedded` フィルタのオプションで直接設定されます。例:
-    Slim::Embedded.default_options[:markdown] = {:auto_ids => false}
+~~~ ruby
+Slim::Embedded.default_options[:markdown] = {:auto_ids => false}
+~~~
 ## Slim の設定
@@ -668,48 +869,59 @@ Slim を設定する方法はコンパイル機構に少し依存します。(Ra
 ### デフォルトオプション
-    # デバック用に html をきれいにインデントし属性をソートしない (Ruby 1.8)
-    Slim::Engine.set_default_options :pretty => true. :sort_attrs => false
+~~~ ruby
+# デバック用に 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
+# デバック用に html をきれいにインデントし属性をソートしない (Ruby 1.9)
+Slim::Engine.set_default_options pretty: true, sort_attrs: false
+~~~
 ハッシュで直接オプションにアクセスすることもできます:
-    Slim::Engine.default_options[:pretty] = true
+~~~ ruby
+Slim::Engine.default_options[:pretty] = true
+~~~
 ### 実行時のオプション設定
 実行時のオプション設定の方法は2つあります。Tilt テンプレート (`Slim::Template`) の場合, テンプレートを
 インスタンス化する時にオプションを設定できます。
-    Slim::Template.new('template.slim', optional_option_hash).render(scope)
+~~~ ruby
+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
+~~~ slim
+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
+~~~ slim
+# 最初のレンダリング呼び出し
+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
+# 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 によって自動的に設定されます |
@@ -717,7 +929,8 @@ Rails ではコンパイルされたテンプレートエンジンのコード
 | 文字列 | :encoding | "utf-8" | テンプレートのエンコーディングを設定 |
 | 文字列 | :default_tag | "div" | タグ名が省略されている場合デフォルトのタグとして使用される |
 | ハッシュ | :shortcut | \{'.' => {:attr => 'class'}, '#' => {:attr => 'id'}} | 属性のショートカット |
-| Hash | :attr_delims | \{'(' => ')', '[' => ']', '{' => '}'} | 属性区切り文字 |
+| ハッシュ | :code_attr_delims | \{'(' => ')', '[' => ']', '{' => '}'} | Ruby コードの属性区切り文字 |
+| ハッシュ | :attr_list_delims | \{'(' => ')', '[' => ']', '{' => '}'} | 属性リスト区切り文字 |
 | 配列&lt;シンボル,文字列&gt; | :enable_engines | nil <i>(すべて可)</i> | 有効な埋め込みエンジンリスト (ホワイトリスト) |
 | 配列&lt;シンボル,文字列&gt; | :disable_engines | nil <i>(無効なし)</i> | 無効な埋め込みエンジンリスト (ブラックリスト) |
 | 真偽値 | :disable_capture | false (Rails では true) | ブロック内キャプチャ無効 (ブロックはデフォルトのバッファに書き込む)  |
@@ -735,6 +948,7 @@ Rails ではコンパイルされたテンプレートエンジンのコード
 | Class | :generator | Temple::Generators::ArrayBuffer/ RailsOutputBuffer | Temple コードジェネレータ (デフォルトのジェネレータは配列バッファを生成します) |
 | 文字列 | :buffer | '_buf' (Rails では '@output_buffer') | バッファに使用される変数 |
 Temple フィルタによってもっと多くのオプションがサポートされていますが一覧には載せず公式にはサポートしません。
 Slim と Temple のコードを確認しなければなりません。
@@ -751,15 +965,19 @@ Slim や Temple のアーキテクチャについてよく知っている開発
 `Temple::Engine` のようにスーパークラスのオプションを設定することも可能です。しかしこれはすべての Temple テンプレートエンジンに影響します。
-    Slim::Engine < Temple::Engine
-    Slim::Compiler < Temple::Filter
+~~~ ruby
+Slim::Engine < Temple::Engine
+Slim::Compiler < Temple::Filter
+~~~
 ## プラグイン
-Slim はロジックレスモードと I18n プラグインを提供しています。プラグインのドキュメントを確認してください。
+Slim はロジックレスモードと I18n, インクルードプラグインを提供しています。プラグインのドキュメントを確認してください。
-* [ロジックレスモード](doc/logic_less.md)
-* [多言語化/I18n](doc/translator.md)
+* [ロジックレスモード](doc/jp/logic_less.md)
+* [パーシャルのインクルード](doc/jp/include.md)
+* [多言語化/I18n](doc/jp/translator.md)
+* [スマートテキストモード](doc/jp/smart.md)
 ## フレームワークサポート
@@ -767,16 +985,19 @@ Slim はロジックレスモードと I18n プラグインを提供していま
 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)
+~~~ ruby
+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'
+~~~ ruby
+require 'sinatra'
 require 'slim'
 get('/') { slim :index }
@@ -789,7 +1010,7 @@ html
     title Slim で Sinatra
   body
     h1 Slim は楽しい!
-</pre>
+~~~
 ### Rails
@@ -814,11 +1035,12 @@ Usage: slimrb [options]
         --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)
+        --rails                      Generate rails compatible code (Implies --compile)
+    -r library                       Load library or plugin with -r slim/plugin
     -t, --translator                 Enable translator plugin
     -l, --logic-less                 Enable logic less plugin
     -p, --pretty                     Produce pretty html
-    -o, --option [NAME=CODE]         Set slim option
+    -o, --option name=code           Set slim option
     -h, --help                       Show this message
     -v, --version                    Print version
 </pre>
@@ -876,7 +1098,9 @@ markdown:
 ベンチマークは `rake bench` で実行します。時間が余計にかかりますが遅い解析ベンチマークを
 実行したい場合 `slow` オプションを追加できます。
-    rake bench slow=1 iterations=1000
+~~~
+rake bench slow=1 iterations=1000
+~~~
 私たちはコミット毎に Travis-CI でベンチマークをとっています。最新のベンチマーク結果はリンク先を確認: <http://travis-ci.org/slim-template/slim>
@@ -893,14 +1117,16 @@ Slim はすべての主要な Ruby 実装で動作します:
 * Ruby 1.8.7, 1.9.3 および 2.0.0
 * Ruby EE
-* JRuby
+* JRuby 1.9 mode
 * Rubinius 2.0
 ## 貢献
 Slim の改良を支援したい場合, Git で管理されているプロジェクトを clone してください。
-    $ git clone git://github.com/slim-template/slim
+~~~
+$ git clone git://github.com/slim-template/slim
+~~~
 魔法をかけた後 pull request を送ってください。私たちは pull request が大好きです！
@@ -957,6 +1183,8 @@ Slim は [MIT license](http://www.opensource.org/licenses/MIT) に基づいて
 移植言語/同様の言語:
+* [Sliq (Slim/Liquid integration)](https://github.com/slim-template/sliq)
+* [Slm (Slim port to Javascript)](https://github.com/slm-lang/slm)
 * [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)
@@ -966,3 +1194,4 @@ Slim は [MIT license](http://www.opensource.org/licenses/MIT) に基づいて
 * [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)
+* [Amber (Similar engine for Go)](https://github.com/eknkc/amber)