haml 1.0.5 → 1.5.0

data/test/sass/templates/constants.sass

@@ -0,0 +1,80 @@
+!width = 10em + 20
+!color = #00ff98
+!main_text = #ffa
+!num = 10
+!dec = 10.2
+!dec_0 = 99.0
+!neg = -10
+!esc= 10\+12
+!str= "Hello!"
+!qstr= "Quo\"ted\"!"
+!hstr= "Hyph-en!"
+!concat = (5 + 4) hi there
+
+#main
+  :content = !str
+  :qstr = !qstr
+  :hstr = !hstr
+  :width = !width
+  :background-color #000
+  :color= !main_text
+  :con= foo bar (!concat boom)
+  :con2= noquo "quo"
+  #sidebar
+    :background-color= !color
+    :num
+      :normal= !num
+      :dec= !dec
+      :dec0= !dec_0
+      :neg= !neg
+    :esc= !esc
+    :many= 1 + 2 + 3
+    :order= 1 + 2 * 3
+    :complex= ((1 + 2) + 15)+#3a8b9f + (hi+(1 +1+ 2)*   4)
+
+#plus
+  :num
+    :num= 5+2
+    :num-un= 10em + 15em
+    :num-un2= 10 + 13em
+    :num-neg= 10 + -.13
+    :str= 100 + px
+    :col= 13 + #aaa
+  :str
+    :str= hi + \ there
+    :str2= hi + " there"
+    :col= "14em solid " + #123
+    :num= times:\  + 13
+  :col
+    :num= #f02 + 123.5
+    :col= #12A + #405162
+
+#minus
+  :num
+    :num= 912 - 12
+  :col
+    :num= #fffffa - 5.2
+    :col= #abcdef - #fedcba
+
+#times
+  :num
+    :num= 2 * 3.5
+    :col= 2 * #3a4b5c
+  :col
+    :num= #12468a * 0.5
+    :col= #121212 * #020304
+    
+#div
+  :num
+    :num= 10 / 3.0
+    :num2= 10 / 3
+  :col
+    :num= #12468a / 2
+    :col= #abcdef / #0f0f0f
+
+#mod
+  :num
+    :num= 17 % 3
+  :col
+    :col= #5f6e7d % #10200a
+    :num= #aaabac % 3

data/test/sass/templates/expanded.sass

@@ -0,0 +1,15 @@
+#main
+  :width 15em
+  :color #0000ff
+  p
+    :border
+      :style dotted
+      :width 2px
+  .cool
+    :width 100px
+
+#left
+  :font
+    :size 2em
+    :weight bold
+  :float left

data/test/sass/templates/nested.sass

@@ -0,0 +1,15 @@
+#main
+  :width 15em
+  :color #0000ff
+  p
+    :border
+      :style dotted
+      :width 2px
+  .cool
+    :width 100px
+
+#left
+  :font
+    :size 2em
+    :weight bold
+  :float left

metadata

@@ -3,9 +3,9 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: haml
 version: !ruby/object:Gem::Version 
-  version: 1.0.5
-date: 2007-01-25 00:00:00 -08:00
-summary: An elegant, structured XHTML/XML templating engine.
+  version: 1.5.0
+date: 2007-03-06 00:00:00 -08:00
+summary: An elegant, structured XHTML/XML templating engine. Comes with Sass, a similar CSS templating engine.
 require_paths: 
 - lib
 email: haml@googlegroups.com
@@ -30,68 +30,116 @@ authors:
 - Hampton Catlin
 files: 
 - lib/haml
+- lib/sass
+- lib/haml.rb
+- lib/sass.rb
 - lib/haml/helpers
 - lib/haml/helpers.rb
 - lib/haml/engine.rb
 - lib/haml/buffer.rb
 - lib/haml/template.rb
+- lib/haml/filters.rb
+- lib/haml/exec.rb
+- lib/haml/error.rb
 - lib/haml/helpers/action_view_mods.rb
+- lib/sass/tree
+- lib/sass/constant
+- lib/sass/plugin.rb
+- lib/sass/engine.rb
+- lib/sass/constant.rb
+- lib/sass/error.rb
+- lib/sass/tree/value_node.rb
+- lib/sass/tree/attr_node.rb
+- lib/sass/tree/rule_node.rb
+- lib/sass/tree/node.rb
+- lib/sass/constant/operation.rb
+- lib/sass/constant/color.rb
+- lib/sass/constant/string.rb
+- lib/sass/constant/number.rb
+- lib/sass/constant/literal.rb
 - bin/haml
-- test/results
-- test/rhtml
-- test/mocks
-- test/templates
-- test/helper_test.rb
+- bin/sass
+- bin/html2haml
+- test/haml
+- test/sass
 - test/profile.rb
-- test/engine_test.rb
-- test/runner.rb
 - test/benchmark.rb
-- test/template_test.rb
-- test/results/eval_suppressed.xhtml
-- test/results/silent_script.xhtml
-- test/results/whitespace_handling.xhtml
-- test/results/very_basic.xhtml
-- test/results/original_engine.xhtml
-- test/results/list.xhtml
-- test/results/just_stuff.xhtml
-- test/results/content_for_layout.xhtml
-- test/results/tag_parsing.xhtml
-- test/results/helpful.xhtml
-- test/results/partials.xhtml
-- test/results/standard.xhtml
-- test/results/helpers.xhtml
-- test/rhtml/standard.rhtml
-- test/mocks/article.rb
-- test/templates/whitespace_handling.haml
-- test/templates/eval_suppressed.haml
-- test/templates/standard.haml
-- test/templates/helpful.haml
-- test/templates/helpers.haml
-- test/templates/silent_script.haml
-- test/templates/partialize.haml
-- test/templates/_text_area.haml
-- test/templates/list.haml
-- test/templates/content_for_layout.haml
-- test/templates/partials.haml
-- test/templates/very_basic.haml
-- test/templates/original_engine.haml
-- test/templates/_partial.haml
-- test/templates/just_stuff.haml
-- test/templates/tag_parsing.haml
+- test/haml/results
+- test/haml/rhtml
+- test/haml/mocks
+- test/haml/templates
+- test/haml/helper_test.rb
+- test/haml/engine_test.rb
+- test/haml/runner.rb
+- test/haml/template_test.rb
+- test/haml/results/whitespace_handling.xhtml
+- test/haml/results/eval_suppressed.xhtml
+- test/haml/results/very_basic.xhtml
+- test/haml/results/original_engine.xhtml
+- test/haml/results/list.xhtml
+- test/haml/results/just_stuff.xhtml
+- test/haml/results/content_for_layout.xhtml
+- test/haml/results/tag_parsing.xhtml
+- test/haml/results/helpful.xhtml
+- test/haml/results/partials.xhtml
+- test/haml/results/standard.xhtml
+- test/haml/results/silent_script.xhtml
+- test/haml/results/helpers.xhtml
+- test/haml/results/filters.xhtml
+- test/haml/rhtml/standard.rhtml
+- test/haml/mocks/article.rb
+- test/haml/templates/standard.haml
+- test/haml/templates/helpful.haml
+- test/haml/templates/whitespace_handling.haml
+- test/haml/templates/helpers.haml
+- test/haml/templates/partialize.haml
+- test/haml/templates/eval_suppressed.haml
+- test/haml/templates/list.haml
+- test/haml/templates/_text_area.haml
+- test/haml/templates/content_for_layout.haml
+- test/haml/templates/partials.haml
+- test/haml/templates/silent_script.haml
+- test/haml/templates/very_basic.haml
+- test/haml/templates/original_engine.haml
+- test/haml/templates/_partial.haml
+- test/haml/templates/just_stuff.haml
+- test/haml/templates/tag_parsing.haml
+- test/haml/templates/filters.haml
+- test/haml/templates/breakage.haml
+- test/sass/tmp
+- test/sass/results
+- test/sass/templates
+- test/sass/plugin_test.rb
+- test/sass/engine_test.rb
+- test/sass/results/constants.css
+- test/sass/results/basic.css
+- test/sass/results/complex.css
+- test/sass/results/expanded.css
+- test/sass/results/nested.css
+- test/sass/results/compact.css
+- test/sass/templates/constants.sass
+- test/sass/templates/complex.sass
+- test/sass/templates/expanded.sass
+- test/sass/templates/bork.sass
+- test/sass/templates/basic.sass
+- test/sass/templates/nested.sass
+- test/sass/templates/compact.sass
 - Rakefile
 - init.rb
 - MIT-LICENSE
 - VERSION
-- REFERENCE
+- README
 test_files: 
-- test/helper_test.rb
-- test/engine_test.rb
-- test/template_test.rb
+- test/haml/helper_test.rb
+- test/haml/engine_test.rb
+- test/haml/template_test.rb
+- test/sass/plugin_test.rb
+- test/sass/engine_test.rb
 rdoc_options: 
 - --title
 - Haml
 - --main
-- REFERENCE
+- README
 - --exclude
 - lib/haml/buffer.rb
 - --line-numbers
@@ -99,9 +147,11 @@ rdoc_options:
 extra_rdoc_files: 
 - MIT-LICENSE
 - VERSION
-- REFERENCE
+- README
 executables: 
 - haml
+- html2haml
+- sass
 extensions: []
 
 requirements: []

data/REFERENCE

@@ -1,662 +0,0 @@
-= Haml (XHTML Abstraction Markup Language)
-
-Haml is a markup language
-that's used to cleanly and simply describe the XHTML of any web document,
-without the use of inline code.
-Haml functions as a replacement
-for inline page templating systems such as PHP, RHTML, and ASP. 
-However, Haml avoids the need for explicitly coding XHTML into the template, 
-because it is actually an abstract description of the XHTML,
-with some code to generate dynamic content.
-
-== Features
-
-* Whitespace active
-* Well-formatted markup
-* DRY
-* Follows CSS conventions
-* Interpolates Ruby code
-* Implements Rails templates with the .haml extension
-
-== Authors
-
-Haml was originally created by Hampton Catlin (hcatlin).
-Help with the Ruby On Rails implementation and much of the documentation
-by Jeff Hardy (packagethief).
-
-Nathan Weizenbaum (Nex3) contributed the buffered-engine code,
-along with many other enhancements
-(including the silent-line syntax: "-").
-
-If you use this software, you must pay Hampton a compliment.
-Say something nice about it.
-Beyond that, the implementation is licensed under the MIT License.
-Ok, fine, I guess that means compliments aren't *required*.
-
-== Formatting
-
-Haml is sensitive to spacing and indentation;
-it uses nesting to convey structure.
-When you want an element to have children,
-indent the lines below it using two spaces.
-Remember, spaces are not the same as tabs.
-For example:
-
-  #contact
-    %h1 Eugene Mumbai
-    %ul.info
-      %li.login eugene
-      %li.email eugene@example.com
-
-is compiled to:
-
-  <div id='contact'>
-    <h1>Eugene Mumbai</h1>
-    <ul class='info'>
-      <li class='login'>eugene</li>
-      <li class='email'>eugene@example.com</li>
-    </ul>
-  </div>
-
-== Characters with meaning to Haml
-
-Various characters, when placed at a certain point in a line,
-instruct Haml to render different types of things.
-
-=== XHTML Tags
-
-These characters render XHTML tags.
-
-==== %
-
-
-This element is placed at the beginning of a line.
-It's followed immediately by the name of an element,
-then optionally by modifiers (see below), a space,
-and text to be rendered inside the element.
-It creates an element in the form of <tt><element></element></tt>.
-For example:
-
-  %one
-    %two
-      %three Hey there
-
-is compiled to:
-
-  <one>
-    <two>
-      <three>Hey there</three>
-    </two>
-  </one>
-
-Any string is a valid element name;
-Haml will automatically generate opening and closing tags for any element.
-
-==== {}
-
-Brackets represent a Ruby hash
-that is used for specifying the attributes of an element.
-It is literally evaluated as a Ruby hash,
-so logic will work in it and local variables may be used.
-Quote characters within the attribute
-will be replaced by appropriate escape sequences.
-The hash is placed after the tag is defined.
-For example:
-
-  %head{ :name => "doc_head" }
-    %script{ 'type' => "text/" + "javascript",
-             :src   => "javascripts/script_#{2 + 7}" }
-
-is compiled to:
-
-  <head name="doc_head">
-    <script src='javascripts/script_9' type='text/javascript'>
-    </script>
-  </head>
-
-==== []
-
-Square brackets follow a tag definition and contain a Ruby object
-that is used to set the class and id of that tag.
-The class is set to the object's class
-(transformed to use underlines rather than camel case)
-and the id is set to the object's class, followed by its id.
-Because the id of an object is normally an obscure implementation detail,
-this is most useful for elements that represent instances of Models.
-For example:
-
-  # file: app/controllers/users_controller.rb
-
-  def show
-    @user = CrazyUser.find(15)
-  end
-
-  # file: app/views/users/show.haml
-
-  %div[@user]
-    %bar[290]/
-    Hello!
-
-is compiled to:
-
-  <div class="crazy_user" id="crazy_user_15">
-    <bar class="fixnum" id="fixnum_581" />
-    Hello!
-  </div>
-
-This is based off of DHH's SimplyHelpful syntax,
-as presented at RailsConf Europe 2006.
-
-==== /
-
-The forward slash character, when placed at the end of a tag definition,
-causes the tag to be self-closed.
-For example:
-
-  %br/
-  %meta{'http-equiv' => 'Content-Type', :content => 'text/html'}/
-
-is compiled to:
-
-  <br />
-  <meta http-equiv='Content-Type' content='text/html' />
-
-==== . and #
-
-The period and pound sign are borrowed from CSS.
-They are used as shortcuts to specify the <tt>class</tt>
-and <tt>id</tt> attributes of an element, respectively.
-Multiple class names can be specified in a similar way to CSS,
-by chaining the class names together with periods.
-They are placed immediately after the tag and before an attributes hash.
-For example:
-
-  %div#things
-    %span#rice Chicken Fried
-    %p.beans{ :food => 'true' } The magical fruit
-    %h1.class.otherclass#id La La La
-
-is compiled to:
-
-  <div id='things'>
-    <span id='rice'>Chicken Fried</span>
-    <p class='beans' food='true'>The magical fruit</p>
-    <h1 class='class otherclass' id='id'>La La La</h1>
-  </div>
-
-And,
-
-  #content
-    .articles
-      .article.title
-        Doogie Howser Comes Out
-      .article.date
-        2006-11-05
-      .article.entry
-        Neil Patrick Harris would like to dispel any rumors that he is straight
-
-is compiled to:
-
-  <div id="content">
-    <div class="articles">
-      <div class="article title">Doogie Howser Comes Out</div>
-      <div class="article date">2006-11-05</div>
-      <div class="article entry">
-        Neil Patrick Harris would like to dispel any rumors that he is straight
-      </div>
-    </div>
-  </div>
-
-==== Implicit Div Elements
-
-Because the div element is used so often, it is the default element.
-If you only define a class and/or id using the <tt>.</tt> or <tt>#</tt> syntax,
-a div element is automatically used.
-For example:
-
-  #collection
-    .item
-      .description What a cool item!
-
-is the same as:
-
-  %div{:id => collection}
-    %div{:class => 'item'}
-      %div{:class => 'description'} What a cool item!
-
-and is compiled to:
-
-  <div id='collection'>
-    <div class='item'>Broken record album</div>
-    <div class='description'>What a cool item!</div>
-  </div>
-
-==== = and ~
-
-<tt>=</tt> and <tt>~</tt> are placed at the end of a tag definition,
-after class, id, and attribute declarations.
-They're just shortcuts for inserting Ruby code into an element.
-They work the same as <tt>=</tt> and <tt>~</tt> without a tag;
-see below for documentation of those.
-However, if the result is short enough,
-it is displayed entirely on one line.
-For example:
-
-  %p= "hello"
-  %h1~ 1 + 2
-
-is not quite the same as:
-
-  %p
-    = "hello"
-  %h1
-    ~ 1 + 2
-
-It's compiled to:
-
-  <p>hello</p>
-  <h1>3</h1>
-
-=== XHTML Helpers
-
-==== No Special Character
-
-If no special character appears at the beginning of a line,
-the line is rendered as plain text.
-For example:
-
-  %gee
-    %whiz
-      Wow this is cool!
-
-is compiled to:
-
-  <gee>
-    <whiz>
-      Wow this is cool!
-    </whiz>
-  </gee>
-
-==== !!!
-
-When describing XHTML documents with Haml,
-you can have a document type or XML prolog generated automatically
-by including the characters <tt>!!!</tt>.
-For example:
-
-  !!! XML
-  !!!
-  %html
-    %head
-      %title Myspace
-    %body
-      %h1 I am the international space station
-      %p Sign my guestbook
-
-is compiled to:
-
-  <?xml version="1.0" encoding="utf-8" ?>
-  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-  <html>
-    <head>
-      <title>Myspace</title>
-    </head>
-    <body>
-      <h1>I am the international space station</h1>
-      <p>Sign my guestbook</p>
-    </body>
-  </html>
-
-You can also specify the version and type of XHTML after the <tt>!!!</tt>.
-XHTML 1.0 Strict, Transitional, and Frameset and XHTML 1.1 are supported.
-The default version is 1.0 and the default type is Transitional.
-For example:
-
-  !!! 1.1
-
-is compiled to:
-
-  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-
-and
-
-  !!! Strict
-
-is compiled to:
-
-  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-
-If you're not using the UTF-8 characterset for your document,
-you can specify which encoding should appear
-in the XML prolog in a similar way.
-For example:
-
-  !!! XML iso-8859-1
-
-is compiled to:
-
-  <?xml version="1.0" encoding="iso-8859-1" ?>
-
-==== /
-
-The forward slash character, when placed at the beginning of a line,
-wraps all text after it in an HTML comment.
-For example:
-
-  %billabong
-    / This is the billabong element
-    I like billabongs!
-
-is compiled to:
-
-  <billabong>
-    <!-- This is the billabong element -->
-    I like billabongs!
-  </billabong>
-
-The forward slash can also wrap indented sections of code. For example:
-
-  /
-    %p This doesn't render...
-    %div
-      %h1 Because it's commented out!
-
-is compiled to:
-
-  <!--
-    <p>This doesn't render...</p>
-    <div>
-      <h1>Because it's commented out!</h1>
-    </div>
-  -->
-
-You can also use Internet Explorer conditional comments
-(about)[http://www.quirksmode.org/css/condcom.html]
-by enclosing the condition in square brackets after the <tt>/</tt>.
-For example:
-
-  /[if IE]
-    %a{ :href => 'http://www.mozilla.com/en-US/firefox/' }
-      %h1 Get Firefox
-
-is compiled to:
-
-  <!--[if IE]>
-    <a href='http://www.mozilla.com/en-US/firefox/'>
-      <h1>Get Firefox</h1>
-    </a>
-  <![endif]-->
-
-==== \
-
-The backslash character escapes the first character of a line,
-allowing use of otherwise interpreted characters as plain text.
-For example:
-
-  %title
-    = @title
-    \- MySite
-
-is compiled to:
-
-  <title>
-    MyPage
-    - MySite
-  </title>
-
-==== |
-
-The pipe character designates a multiline string.
-It's placed at the end of a line
-and means that all following lines that end with <tt>|</tt>
-will be evaluated as though they were on the same line.
-For example:
-
-  %whoo
-    %hoo I think this might get |
-      pretty long so I should |
-      probably make it |
-      multiline so it doesn't |
-      look awful. |
-    %p This is short.
-
-is compiled to:
-
-  %hoo I think this might get |
-    pretty long so I should |
-    probably make it |
-    multiline so it doesn't |
-    look awful. |
-
-=== Ruby evaluators
-
-==== =
-
-The equals character is followed by Ruby code,
-which is evaluated and the output inserted into the document as plain text.
-For example:
-
-  %p
-    = ['hi', 'there', 'reader!'].join " "
-    = "yo"
-
-is compiled to:
-
-  <p>
-    hi there reader!
-    yo
-  </p>
-
-==== ~
-
-The tilde character works the same as the equals character,
-but the output is modified in such a way
-that newlines in whitespace-sensitive elements work properly.
-For example:
-
-  %foo
-    = "Woah    <pre>  this is   \n</pre>    crazy"
-  %foo2
-    ~ "Woah    <pre>  this is   \n</pre>    crazy"
-
-is compiled to:
-
-  <foo>
-    Woah    <pre>  this is
-    </pre>    crazy
-  </foo>
-  <foo2>
-    Woah    <pre>  this is   &#x000A;</pre>    crazy
-  </foo2>
-
-If the ~ character isn't followed by text,
-it doesn't evaluate Ruby at all.
-Instead, an indented section following it will be rendered
-in a whitespace-sensitive manner,
-using HTML encodings for newlines.
-For example:
-
-For example:
-
-  .house
-    %pre
-      ~
-         /^^^\
-        |[] []|
-        |_____|
-
-is compiled to:
-
-  <div class="house">
-    <pre>
-      &#x000A; /^^^\&#x000A;|[] []|&#x000A;|_____|&#x000A;
-    </pre>
-  </div>
-
-==== -
-
-The hyphen character makes the text following it into "silent script":
-Ruby script that is evaluated, but not output.
-
-<b>It is not recommended that you use this widely;
-almost all processing code and logic should be restricted
-to the Controller, the Helper, or partials.</b>
-
-For example:
-
-  - foo = "hello"
-  - foo << " there"
-  - foo << " you!"
-  %p= foo
-
-is compiled to:
-
-  <p>
-    hello there you!
-  </p>
-
-===== Blocks
-
-Ruby blocks, like XHTML tags, don't need to be explicitly closed in Haml.
-Rather, they're automatically closed, based on indentation.
-A block begins whenever the indentation is increased
-after a silent script command.
-It ends when the indentation decreases
-(as long as it's not an +else+ clause or something similar).
-For example:
-
-  - (42...47).each do |i|
-    %p= i
-  %p See, I can count!
-
-is compiled to:
-
-  <p>
-    42
-  </p>
-  <p>
-    43
-  </p>
-  <p>
-    44
-  </p>
-  <p>
-    45
-  </p>
-  <p>
-    46
-  </p>
-
-Another example:
-
-  %p
-    - case 2
-    - when 1
-      = "1!"
-    - when 2
-      = "2?"
-    - when 3
-      = "3."
-
-is compiled to:
-
-  <p>
-    2?
-  </p>
-
-== Using Haml as a Rails plugin
-
-Write Rails templates with the .haml extension.
-For example:
-
-  # file: app/views/movies/teen_wolf.haml
-
-  %html
-    %head
-      %title= "Teen Wolf (1985)"
-    %body
-      #contents
-        %h1 "A highschooler discovers that he is a werewolf"
-        %ul.cast
-          %li "Scott Howard"
-          %li "Rupert 'Stiles' Stilinski"
-          %li "Lisa 'Boof' Marconi"
-          %li "Lewis"
-
-is compiled to:
-
-  <html>
-    <head>
-      <title>Teen Wolf (1985)</title>
-    </head>
-    <body>
-      <div id='contents'>
-        <h1>A highschooler discovers that he is a werewolf</h1>
-        <ul class='cast'>
-          <li>Scott Howard</li>
-          <li>Rupert 'Stiles' Stilinski</li>
-          <li>Lisa 'Boof' Marconi</li>
-          <li>Lewis</li>
-        </ul>
-      </div>
-    </body>
-  </html>
-
-You can access instance variables in Haml templates
-the same way you do in ERb templates.
-Helper methods are also available in Haml templates.
-For example:
-
-  # file: app/controllers/movies_controller.rb
-
-  class MoviesController < ApplicationController
-    def index
-      @title = "Teen Wolf"
-    end
-  end
-
-  # file: app/views/movies/index.haml
-
-  #content
-   .title
-     %h1= @title
-     = link_to 'Home', home_url
-
-may be compiled to:
-
-  <div id='content'>
-    <div class='title'>
-      <h1>Teen Wolf</h1>
-      <a href='/'>Home</a>
-    </div>
-  </div>
-
-=== Setting Options
-
-Options can be set by setting the hash <tt>Haml::Template.options</tt>
-from <tt>environment.rb</tt>.
-Available options are:
-
-[<tt>:suppress_eval</tt>] Whether or not attribute hashes and Ruby scripts
-                          designated by <tt>=</tt> or <tt>~</tt> should be
-                          evaluated. If this is true, said scripts are
-                          rendered as empty strings. Defaults to false.
-
-[<tt>:precompiled</tt>]   A string containing a precompiled Haml template.
-                          If this is passed, <tt>template</tt> is ignored
-                          and no precompilation is done.
-
-[<tt>:attr_wrapper</tt>]  The character that should wrap element attributes.
-                          This defaults to <tt>'</tt> (an apostrophe). Characters
-                          of this type within the attributes will be escaped
-                          (e.g. by replacing them with <tt>&apos;</tt>) if
-                          the character is an apostrophe or a quotation mark.
-
-[<tt>:locals</tt>]        The local variables that will be available within the
-                          template. For instance, if <tt>:locals</tt> is
-                          <tt>{ :foo => "bar" }</tt>, then within the template,
-                          <tt>= foo</tt> will produce <tt>bar</tt>.
-
----
-Copyright (c) 2006 Hampton Catlin
-Licensed under the MIT License