typo 4.0.3 → 4.1

data/vendor/plugins/delicious_sidebar/init.rb

@@ -0,0 +1,5 @@
+require 'sidebar'
+require 'delicious_sidebar'
+
+DeliciousSidebar.view_root = File.dirname(__FILE__) + '/views'
+

data/{components/plugins/sidebars/delicious_controller.rb → vendor/plugins/delicious_sidebar/lib/delicious_sidebar.rb}

@@ -1,4 +1,4 @@
-class Plugins::Sidebars::DeliciousController < Sidebars::ComponentPlugin
+class DeliciousSidebar < Sidebar
   display_name "Del.icio.us"
   description 'Bookmarks from <a href="http://del.icio.us">del.icio.us</a>'
 
@@ -8,22 +8,28 @@ class Plugins::Sidebars::DeliciousController < Sidebars::ComponentPlugin
   setting :description, false, :input_type => :checkbox, :label => 'Show description'
   setting :desclink,    false, :input_type => :checkbox, :label => 'Allow links in description'
 
-  def content
-    response.lifetime = 1.hour
-    @delicious = check_cache(Delicious, @sb_config['feed']) rescue nil
+  lifetime 1.hour
 
-    return unless @delicious
+  def delicious
+    @delicious ||= Delicious.new(feed) rescue nil
+  end
+
+  def parse_request(contents, params)
+    return unless delicious
 
-    if @sb_config['groupdate']
+    if groupdate
       @delicious.days = {}
       @delicious.items.each_with_index do |d,i|
-        break if i >= @sb_config['count'].to_i
+        break if i >= count.to_i
         index = d.date.strftime("%Y-%m-%d").to_sym
-        (@delicious.days[index] ||= Array.new) << d
+        (@delicious.days[index] ||= []) << d
+      end
+      @delicious.days =
+        @delicious.days.sort_by { |d| d.to_s }.reverse.collect do |d|
+        {:container => d.last, :date => d.first}
       end
-      @delicious.days = @delicious.days.sort_by { |d| d.to_s }.reverse.collect { |d| {:container => d.last, :date => d.first} }
     else
-      @delicious.items = @delicious.items.slice(0, @sb_config['count'].to_i)
+      @delicious.items = @delicious.items.slice(0, count.to_i)
     end
   end
 end

data/vendor/plugins/delicious_sidebar/test/delicious_sidebar_test.rb

@@ -0,0 +1,8 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+
+class DeliciousSidebarTest < Test::Unit::TestCase
+  def test_sidebar_is_available
+    assert Sidebar.available_sidebars.include?(DeliciousSidebar)
+  end
+end

data/vendor/plugins/delicious_sidebar/views/content.rhtml

@@ -0,0 +1,20 @@
+<% if sidebar.delicious -%>
+  <div id="delicious">
+    <h3><a href="http://<%=h sidebar.delicious.title %>"><%=h sidebar.delicious.title %></a></h3>
+    <% (groupdate ? sidebar.delicious.days : [{ :container => sidebar.delicious.items }]).each do |group| -%>
+    <% if groupdate -%>
+    <span class="date"><%=h group[:date].to_s.to_date.strftime("%b %d") %></span>
+    <% end -%>
+    <ul>
+      <% for item in group[:container] %>
+      <li>
+        <a href="<%=h item.link %>" title="<%=h item.description%>"><%=h item.title %></a>
+        <% if item.description -%>
+          <br /><span class="desc"><%=h desclink ? item.description_link : item.description %></span>
+        <% end -%>
+      </li>
+      <% end -%>
+    </ul>
+    <% end -%>
+  </div>
+<% end -%>

data/vendor/plugins/flickr_sidebar/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the flickr_sidebar plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the flickr_sidebar plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'FlickrSidebar'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/vendor/plugins/flickr_sidebar/init.rb

@@ -0,0 +1,5 @@
+require 'sidebar'
+require 'flickr_sidebar'
+
+FlickrSidebar.view_root = File.dirname(__FILE__) + '/views'
+

data/{app/models/aggregations → vendor/plugins/flickr_sidebar/lib}/flickr.rb

@@ -35,7 +35,7 @@ class FlickrAggregation
     end
 
     def image
-      description.scan( /(http:\/\/(static|photos).*?\.jpg)/ ).first.first
+      description.scan( /(http:\/\/(farm1|farm2|static|photos).*?\.jpg)/ ).first.first 
     end
     def thumb
       image.gsub( /\_m\./, '_t.' )

data/vendor/plugins/flickr_sidebar/lib/flickr_sidebar.rb

@@ -0,0 +1,15 @@
+class FlickrSidebar < Sidebar
+  description 'Pictures from <a href="http://www.flickr.com">flickr.com</a>'
+  setting :feed_url, nil
+  setting :count,    4
+  setting :format,  'rectangle', :choices => %w{rectangle square}
+
+  lifetime 1.hour
+
+  def flickr
+    @flickr ||= FlickrAggregation.new(feed_url)
+  rescue Exception => e
+    logger.info e
+    nil
+  end
+end

data/vendor/plugins/flickr_sidebar/test/flickr_sidebar_test.rb

@@ -0,0 +1,8 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+
+class FlickrSidebarTest < Test::Unit::TestCase
+  def test_sidebar_is_available
+    assert Sidebar.available_sidebars.include?(FlickrSidebar)
+  end
+end

data/{components/plugins/sidebars/flickr → vendor/plugins/flickr_sidebar/views}/content.rhtml

@@ -1,8 +1,8 @@
-<% if @flickr -%>
+<% if sidebar.flickr -%>
 <div id="flickr">
-<h3><%= @flickr.title  %> (<%= link_to "flickr", @flickr.link %>)</h3>
-<% for pic in @flickr.choose(@sb_config['count'].to_i) -%>
-  <div class="flickr<%= @sb_config['format']%>"><%= case @sb_config['format']
+<h3><%= sidebar.flickr.title  %> (<%= link_to "flickr", sidebar.flickr.link %>)</h3>
+<% for pic in sidebar.flickr.choose(count.to_i) -%>
+  <div class="flickr<%= format %>"><%= case format
           when 'square':
             link_to image_tag(pic.square, :alt => pic.title, :title => pic.title),pic.link
           when 'rectangle':
@@ -12,4 +12,4 @@
 </div>
   <% end -%>
 </div>
-<% end -%>
+<% end -%>

data/vendor/plugins/fortythree_sidebar/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the fortythree_sidebar plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the fortythree_sidebar plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'FortythreeSidebar'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/vendor/plugins/fortythree_sidebar/init.rb

@@ -0,0 +1,5 @@
+require 'sidebar'
+require 'fortythree_sidebar'
+
+FortythreeSidebar.view_root = File.dirname(__FILE__) + '/views'
+

data/{components/plugins/sidebars/fortythree_controller.rb → vendor/plugins/fortythree_sidebar/lib/fortythree_sidebar.rb}

@@ -1,12 +1,13 @@
-class Plugins::Sidebars::FortythreeController < Sidebars::ComponentPlugin
+class FortythreeSidebar < Sidebar
   display_name "43things"
   description 'Goals from <a href="http://www.43things.com/">43things.com</a>.'
 
   setting :feed, 'http://www.43things.com/rss/uber/author?username=USER', :label => 'Feed URL'
   setting :count, 43, :label => 'Items limit'
 
-  def content
-    response.lifetime = 1.day
-    @fortythree=check_cache(Fortythree, @sb_config['feed']) rescue nil
+  lifetime 1.day
+
+  def fortythree
+    @fortythree ||= Fortythree.new(feed) rescue nil
   end
 end

data/vendor/plugins/fortythree_sidebar/test/fortythree_sidebar_test.rb

@@ -0,0 +1,8 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+
+class FortythreeSidebarTest < Test::Unit::TestCase
+  def test_sidebar_is_available
+    assert Sidebar.available_sidebars.include?(FortythreeSidebar)
+  end
+end

data/vendor/plugins/fortythree_sidebar/views/content.rhtml

@@ -0,0 +1,8 @@
+<% if sidebar.fortythree -%>
+<h3><%= link_to "43 Things", sidebar.fortythree.link %></h3>
+<ul>
+<% for thing in sidebar.fortythree.things.to_a.slice(0,count.to_i) -%>
+  <li><a href="<%= thing.link %>" title="<%=h thing.title %>"><%=h thing.title %> </a></li>
+<% end -%>
+</ul>
+<% end -%>

data/vendor/plugins/fortythreeplaces_sidebar/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the fortythreeplaces_sidebar plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the fortythreeplaces_sidebar plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'FortythreeplacesSidebar'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/vendor/plugins/fortythreeplaces_sidebar/init.rb

@@ -0,0 +1,5 @@
+require 'sidebar'
+require 'fortythreeplaces_sidebar'
+
+FortythreeplacesSidebar.view_root = File.dirname(__FILE__) + '/views'
+

data/vendor/plugins/fortythreeplaces_sidebar/lib/fortythree.rb

@@ -0,0 +1,62 @@
+require 'open-uri'
+require 'time'
+require 'rexml/document'
+
+# Example:
+#
+# fortythree = Fortythree.new('http://www.43things.com/rss/uber/author?username=<user>')
+# fortythree.things.each do |thing|
+#   puts "#{thing.title} @ #{thing.link} updated at #{thing.date}"
+# end
+#
+class Fortythree
+  include REXML
+
+  attr_accessor :url, :things, :link, :title, :description
+
+  # This object holds given information of a thing
+  class ThingItem < Struct.new(:link, :title, :date)
+    def to_s; title end
+    def date=(value); super(Time.parse(value)) end
+  end
+
+  # Pass the url to the RSS feed you would like to keep tabs on
+  # by default this will request the rss from the server right away and
+  # fill the tasks array  def initialize(url, refresh = true)
+  def initialize(url, refresh = true)
+    self.things  = []
+    self.url    = url
+    self.refresh if refresh
+  end
+
+  # This method lets you refresh the things into the things array
+  # useful if you keep the object cached in memory and
+  def refresh
+    open(@url) do |http|
+      parse(http.read)
+    end
+  end
+
+private
+
+  def parse(body)
+
+    xml = Document.new(body)
+
+    self.things        = []
+    self.link         = XPath.match(xml, "//channel/link/text()").to_s
+    self.title        = XPath.match(xml, "//channel/title/text()").to_s
+    self.description  = XPath.match(xml, "//channel/description/text()").to_s
+
+    XPath.each(xml, "//item/") do |elem|
+
+      thing = ThingItem.new
+      thing.title = XPath.match(elem, "title/text()").to_s
+
+      thing.date  = XPath.match(elem, "pubDate/text()").to_s
+      thing.link  = XPath.match(elem, "link/text()").to_s
+
+      things << thing
+    end
+  end
+end

data/{components/plugins/sidebars/fortythreeplaces_controller.rb → vendor/plugins/fortythreeplaces_sidebar/lib/fortythreeplaces_sidebar.rb}

@@ -1,12 +1,13 @@
-class Plugins::Sidebars::FortythreeplacesController < Sidebars::ComponentPlugin
+class FortythreeplacesSidebar < Sidebar
   display_name "43places"
   description 'List of your <a href="http://www.43places.com/">43places.com</a>.'
 
   setting :feed, 'http://www.43places.com/rss/uber/author?username=USER', :label => 'Feed URL'
   setting :count, 43, :label => 'Items limit'
 
-  def content
-    response.lifetime = 1.day
-    @fortythreeplaces=check_cache(Fortythree, @sb_config['feed']) rescue nil
+  lifetime 1.day
+
+  def fortythreeplaces
+    @fortythreeplaces ||= Fortythree.new(feed) rescue nil
   end
 end

data/vendor/plugins/fortythreeplaces_sidebar/test/fortythreeplaces_sidebar_test.rb

@@ -0,0 +1,8 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+
+class FortythreeplacesSidebarTest < Test::Unit::TestCase
+  def test_sidebar_is_available
+    assert Sidebar.available_sidebars.include?(FortythreeplacesSidebar)
+  end
+end

data/vendor/plugins/fortythreeplaces_sidebar/views/content.rhtml

@@ -0,0 +1,8 @@
+<% if sidebar.fortythreeplaces -%>
+<h3><%= link_to "43 Places", sidebar.fortythreeplaces.link %></h3>
+<ul>
+<% for thing in sidebar.fortythreeplaces.things.to_a.slice(0,count.to_i) -%>
+  <li><a href="<%= thing.link %>" title="<%=h thing.title %>"><%=h thing.title %> </a></li>
+<% end -%>
+</ul>
+<% end -%>

data/vendor/plugins/haml/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2006 Hampton Catlin
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/vendor/plugins/haml/REFERENCE

@@ -0,0 +1,662 @@
+= 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' 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