RubyGems - mab - Versions diffs - 0.0.2 → 0.0.3 - Mend

mab 0.0.2 → 0.0.3

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 (113) hide show

checksums.yaml +15 -0
data/Gemfile +5 -1
data/Gemfile.lock +3 -3
data/Rakefile +10 -2
data/lib/mab.rb +1 -0
data/lib/mab/indentation.rb +2 -2
data/lib/mab/mixin.rb +57 -57
data/lib/mab/rails.rb +20 -0
data/lib/mab/version.rb +1 -1
data/test/rails/Rakefile +7 -0
data/test/rails/app/assets/images/rails.png +0 -0
data/test/rails/app/assets/javascripts/application.js +15 -0
data/test/rails/app/assets/stylesheets/application.css +13 -0
data/test/rails/app/controllers/application_controller.rb +17 -0
data/test/rails/app/helpers/application_helper.rb +2 -0
data/test/rails/app/views/application/content_for.html.mab +6 -0
data/test/rails/app/views/application/normal.html.mab +2 -0
data/test/rails/app/views/application/variables.html.mab +2 -0
data/test/rails/app/views/layouts/application.html.mab +15 -0
data/test/rails/config.ru +4 -0
data/test/rails/config/application.rb +54 -0
data/test/rails/config/boot.rb +6 -0
data/test/rails/config/environment.rb +5 -0
data/test/rails/config/environments/development.rb +27 -0
data/test/rails/config/environments/production.rb +67 -0
data/test/rails/config/environments/test.rb +29 -0
data/test/rails/config/initializers/backtrace_silencers.rb +7 -0
data/test/rails/config/initializers/inflections.rb +15 -0
data/test/rails/config/initializers/mime_types.rb +5 -0
data/test/rails/config/initializers/secret_token.rb +7 -0
data/test/rails/config/initializers/session_store.rb +8 -0
data/test/rails/config/initializers/wrap_parameters.rb +14 -0
data/test/rails/config/locales/en.yml +5 -0
data/test/rails/config/routes.rb +3 -0
data/test/rails/script/rails +6 -0
data/test/rails/test/helper.rb +7 -0
data/test/rails/test/test_mab.rb +40 -0
data/test/test_mab_mixin.rb +10 -6
metadata +46 -88
data/bench.rb +0 -37
data/mab-0.0.1.gem +0 -0
data/markaby/CHANGELOG.rdoc +0 -106
data/markaby/Markaby.gemspec +0 -109
data/markaby/README.rdoc +0 -317
data/markaby/Rakefile +0 -78
data/markaby/VERSION +0 -1
data/markaby/garlic.rb +0 -29
data/markaby/init.rb +0 -6
data/markaby/lib/markaby.rb +0 -30
data/markaby/lib/markaby/builder.rb +0 -314
data/markaby/lib/markaby/builder_tags.rb +0 -64
data/markaby/lib/markaby/cssproxy.rb +0 -55
data/markaby/lib/markaby/kernel_method.rb +0 -7
data/markaby/lib/markaby/rails.rb +0 -75
data/markaby/lib/markaby/rails/current.rb +0 -85
data/markaby/lib/markaby/rails/deprecated.rb +0 -124
data/markaby/lib/markaby/rails/rails_builder.rb +0 -91
data/markaby/lib/markaby/sinatra.rb +0 -18
data/markaby/lib/markaby/tags.rb +0 -200
data/markaby/lib/markaby/tilt.rb +0 -8
data/markaby/spec/markaby/builder_spec.rb +0 -118
data/markaby/spec/markaby/css_proxy_test.rb +0 -47
data/markaby/spec/markaby/fragment_test.rb +0 -10
data/markaby/spec/markaby/markaby_other_static.mab +0 -1
data/markaby/spec/markaby/markaby_spec.rb +0 -184
data/markaby/spec/markaby/markaby_test.rb +0 -251
data/markaby/spec/markaby/rails/spec_helper.rb +0 -29
data/markaby/spec/markaby/rails/views/layouts/layout.mab +0 -11
data/markaby/spec/markaby/rails/views/markaby/_a_partial.mab +0 -3
data/markaby/spec/markaby/rails/views/markaby/_form_for_with_body_in_erb.erb +0 -1
data/markaby/spec/markaby/rails/views/markaby/_partial_child_with_locals.mab +0 -1
data/markaby/spec/markaby/rails/views/markaby/access_to_helpers.mab +0 -1
data/markaby/spec/markaby/rails/views/markaby/broken.mab +0 -7
data/markaby/spec/markaby/rails/views/markaby/commented_out_template.mab +0 -1
data/markaby/spec/markaby/rails/views/markaby/correct_template_values.mab +0 -5
data/markaby/spec/markaby/rails/views/markaby/double_output.mab +0 -8
data/markaby/spec/markaby/rails/views/markaby/form_for.mab +0 -2
data/markaby/spec/markaby/rails/views/markaby/form_for_with_fields.mab +0 -3
data/markaby/spec/markaby/rails/views/markaby/form_for_with_multiple_fields.mab +0 -4
data/markaby/spec/markaby/rails/views/markaby/no_values_passed.mab +0 -3
data/markaby/spec/markaby/rails/views/markaby/partial_parent.mab +0 -1
data/markaby/spec/markaby/rails/views/markaby/partial_parent_with_locals.mab +0 -7
data/markaby/spec/markaby/rails/views/markaby/render_erb_without_explicit_render_call.erb +0 -1
data/markaby/spec/markaby/rails/views/markaby/render_explicit_but_empty_markaby_layout.mab +0 -0
data/markaby/spec/markaby/rails/views/markaby/render_mab_without_explicit_render_call.mab +0 -3
data/markaby/spec/markaby/rails/views/markaby/render_with_ivar.mab +0 -3
data/markaby/spec/markaby/rails/views/markaby/renders_erb.rhtml +0 -1
data/markaby/spec/markaby/rails/views/markaby/renders_form_for_with_erb_body.mab +0 -3
data/markaby/spec/markaby/rails/views/markaby/routes.mab +0 -1
data/markaby/spec/markaby/rails/views/markaby/yielding.mab +0 -3
data/markaby/spec/markaby/rails/views/markaby/yielding_content_for_with_block_helper.mab +0 -5
data/markaby/spec/markaby/rails/views/markaby/yielding_two.mab +0 -7
data/markaby/spec/markaby/rails/views/markaby/yielding_with_content_for.mab +0 -3
data/markaby/spec/markaby/rails_test.rb +0 -380
data/markaby/spec/markaby/rails_version_spec.rb +0 -37
data/markaby/spec/markaby/sinatra/app.rb +0 -49
data/markaby/spec/markaby/sinatra/sinatra_spec.rb +0 -67
data/markaby/spec/markaby/sinatra/views/helpers.mab +0 -1
data/markaby/spec/markaby/sinatra/views/layout.mab +0 -7
data/markaby/spec/markaby/sinatra/views/markaby_template.mab +0 -0
data/markaby/spec/markaby/sinatra/views/scope_instance_variables.mab +0 -3
data/markaby/spec/markaby/sinatra/views/simple_html.mab +0 -4
data/markaby/spec/markaby/sinatra/views/variables.mab +0 -3
data/markaby/spec/markaby/tilt/erb.erb +0 -1
data/markaby/spec/markaby/tilt/locals.mab +0 -1
data/markaby/spec/markaby/tilt/markaby.mab +0 -1
data/markaby/spec/markaby/tilt/markaby_other_static.mab +0 -1
data/markaby/spec/markaby/tilt/render_twice.mab +0 -1
data/markaby/spec/markaby/tilt/scope.mab +0 -1
data/markaby/spec/markaby/tilt/yielding.mab +0 -2
data/markaby/spec/markaby/tilt_spec.rb +0 -75
data/markaby/spec/spec.opts +0 -2
data/markaby/spec/spec_helper.rb +0 -44

data/bench.rb DELETED

@@ -1,37 +0,0 @@
-$: << 'lib'
-TMPL = <<-'EOF'
-div.menu! do
-  [1, 2, 3, 4].map { |n| a("Section #{n}", :href => "/section/#{n}") }.join ' | '
-end
-EOF
-require 'mab'
-class MabExample
-  include Mab::Mixin::XHTML5
-  class_eval "def content() #{TMPL} end"
-  def to_html
-    mab { content }
-  end
-end
-require 'erector'
-class ErectorExample < Erector::Widget
-  class_eval "def content() #{TMPL} end"
-end
-puts MabExample.new.to_html
-puts ErectorExample.new.to_html
-require 'benchmark/ips'
-Benchmark.ips do |x|
-  x.report('Mab')     { MabExample.new.to_html }
-  x.report('Erector') { ErectorExample.new.to_html }
-end

data/mab-0.0.1.gem DELETED

Binary file

data/markaby/CHANGELOG.rdoc DELETED

@@ -1,106 +0,0 @@
-= 0.7.1 (2010-08-19)
-* Rails fixes for form_for called from erb templates
-= 0.7.0
-* Sinatra 1.0 support
-* Full Tilt 1.0+ support, including "yield" support for layouts
-= 0.6.10
-* Rails fixes for form_for + content_for
-= 0.6.9
-* Bug fix for url_for.  Previously, you'd need to capture { *_path } instead of
-  using the named route directly.  Only affected rails 2.3.4+.
-= 0.6.8 (2010-06-03)
-* Add a regression for issue Github #17 (for judofyr / Camping)
-= 0.6.7 (2010-06-02)
-* Add rails support for 2.3.5 - 2.3.8
-* Improved rails documentation
-= 0.6.6 (2010-06-01)
-* ruby 1.9.1 support.  Closes Github Issues #10 & #11.
-* Removed Tilt deprecation warnings
-= 0.6.4
-* Fixed a bug in which direct string values to Markaby::Builder wouldn't evaluate:
-    Markaby::Builder.new { 'foo' }.to_s #=> "foo"
-* Fix critical bug with form_for, which was raising an error
-* Introduce proxy object for form_for:
-    form_for :foo do |f|
-      f.text_field :bar
-      f.text_field :baz
-    end
-* Remove support for rails 2.1.x series.  We'll accept patches for them, if anyone cares enough.
-== 0.6.2 / 0.6.3
-* Add basic support for the Tilt templating engine (used with Sinatra):
-  require 'markaby'
-  require 'markaby/tilt'
-== 0.6.1
-* Support the following rails versions:
-    1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.2.6, 2.1.0, 2.1.1, 2.1.2, 2.2.0,
-    2.2.1, 2.2.2, 2.2.3, 2.3.1, 2.3.2, 2.3.2.1, 2.3.3, 2.3.3.1, 2.3.4
-* Only run rails tests when inside a rails plugins
-* Run tests of the various versions of rails with garlic
-* Start conversion to rspec.  Use test/spec temporarily until conversion is done.
-= 0.6
-=== 23 August, 2009
-* Canonical repo changed to http://github.com/joho/markaby
-* Gem moved to Github (using jeweler)
-* Rails init process changed to work with rails > 2.1
-* Default attributes on the root (<html>) element can now be overidden
-* Reworked CssProxy, allowing attributes on hr and br
-* Added Kernel#mab convenience method (require 'markaby/kernel_method')
-* WhenOnRails: Can now use :locals with render_markaby
-* WhenOnRails: Template errors now report line number
-= 0.5
-=== 03 October, 2006
-* XHTML Validation built in.  So, if you have an invalid tag: error.  Invalid attribute: error.
-  And two identical IDs in the same document: error.  Optional, of course.  But handy!
-* New Markaby::Fragment class adds much flexibility.  If it discovers you are using a tag as a string,
-  the tag is removed from the stream.  (<tt>div { strong("Real") + " Giraffes" }</tt>)
-* The prevailing rule now is: if you want it escaped, pass it as an arg.  If not, pass it to a block.
-* Again, escaped: <tt>h1("Me & You Have a Giraffe")</tt>
-* And, not escaped: <tt>h1 { "<a href='/'>Home</a>" }</tt>
-* Less method_missing, meaning: faster calls all around.  Tag methods generated based on doctype.
-* The <tt>html</tt> method doesn't write the doctype tags and meta tags.  You must use <tt>xhtml_transitional</tt> or <tt>xhtml_strict</tt> methods to do that.
-* The <tt>img</tt> method doesn't try to inject an empty alt tag and a zero border.  No more of that.
-= 0.3
-=== 02nd February, 2006
-* Allow Markaby::Builder.new without args.
-* Rails helper method render_markaby.
-= 0.2
-=== 17th January, 2006
-* Public announcement.
-* DOCTYPES, head tags.
-* Works with Rails helpers.
-= 0.1
-=== 05th January, 2006
-* Initial import.

data/markaby/Markaby.gemspec DELETED

@@ -1,109 +0,0 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-Gem::Specification.new do |s|
-  s.name = %q{markaby}
-  s.version = "0.7.2"
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = [%q{_why}, %q{Tim Fletcher}, %q{John Barton}, %q{spox}, %q{smtlaissezfaire}]
-  s.date = %q{2011-08-23}
-  s.description = %q{Tim Fletcher and _why's ruby driven HTML templating system}
-  s.email = %q{scott@railsnewbie.com}
-  s.extra_rdoc_files = [
-    "README.rdoc"
-  ]
-  s.files = [
-    "CHANGELOG.rdoc",
-    "Markaby.gemspec",
-    "README.rdoc",
-    "Rakefile",
-    "VERSION",
-    "garlic.rb",
-    "init.rb",
-    "lib/markaby.rb",
-    "lib/markaby/builder.rb",
-    "lib/markaby/builder_tags.rb",
-    "lib/markaby/cssproxy.rb",
-    "lib/markaby/kernel_method.rb",
-    "lib/markaby/rails.rb",
-    "lib/markaby/rails/current.rb",
-    "lib/markaby/rails/deprecated.rb",
-    "lib/markaby/rails/rails_builder.rb",
-    "lib/markaby/sinatra.rb",
-    "lib/markaby/tags.rb",
-    "lib/markaby/tilt.rb",
-    "spec/markaby/builder_spec.rb",
-    "spec/markaby/css_proxy_test.rb",
-    "spec/markaby/fragment_test.rb",
-    "spec/markaby/markaby_other_static.mab",
-    "spec/markaby/markaby_spec.rb",
-    "spec/markaby/markaby_test.rb",
-    "spec/markaby/rails/spec_helper.rb",
-    "spec/markaby/rails/views/layouts/layout.mab",
-    "spec/markaby/rails/views/markaby/_a_partial.mab",
-    "spec/markaby/rails/views/markaby/_form_for_with_body_in_erb.erb",
-    "spec/markaby/rails/views/markaby/_partial_child_with_locals.mab",
-    "spec/markaby/rails/views/markaby/access_to_helpers.mab",
-    "spec/markaby/rails/views/markaby/broken.mab",
-    "spec/markaby/rails/views/markaby/commented_out_template.mab",
-    "spec/markaby/rails/views/markaby/correct_template_values.mab",
-    "spec/markaby/rails/views/markaby/double_output.mab",
-    "spec/markaby/rails/views/markaby/form_for.mab",
-    "spec/markaby/rails/views/markaby/form_for_with_fields.mab",
-    "spec/markaby/rails/views/markaby/form_for_with_multiple_fields.mab",
-    "spec/markaby/rails/views/markaby/no_values_passed.mab",
-    "spec/markaby/rails/views/markaby/partial_parent.mab",
-    "spec/markaby/rails/views/markaby/partial_parent_with_locals.mab",
-    "spec/markaby/rails/views/markaby/render_erb_without_explicit_render_call.erb",
-    "spec/markaby/rails/views/markaby/render_explicit_but_empty_markaby_layout.mab",
-    "spec/markaby/rails/views/markaby/render_mab_without_explicit_render_call.mab",
-    "spec/markaby/rails/views/markaby/render_with_ivar.mab",
-    "spec/markaby/rails/views/markaby/renders_erb.rhtml",
-    "spec/markaby/rails/views/markaby/renders_form_for_with_erb_body.mab",
-    "spec/markaby/rails/views/markaby/routes.mab",
-    "spec/markaby/rails/views/markaby/yielding.mab",
-    "spec/markaby/rails/views/markaby/yielding_content_for_with_block_helper.mab",
-    "spec/markaby/rails/views/markaby/yielding_two.mab",
-    "spec/markaby/rails/views/markaby/yielding_with_content_for.mab",
-    "spec/markaby/rails_test.rb",
-    "spec/markaby/rails_version_spec.rb",
-    "spec/markaby/sinatra/app.rb",
-    "spec/markaby/sinatra/sinatra_spec.rb",
-    "spec/markaby/sinatra/views/helpers.mab",
-    "spec/markaby/sinatra/views/layout.mab",
-    "spec/markaby/sinatra/views/markaby_template.mab",
-    "spec/markaby/sinatra/views/scope_instance_variables.mab",
-    "spec/markaby/sinatra/views/simple_html.mab",
-    "spec/markaby/sinatra/views/variables.mab",
-    "spec/markaby/tilt/erb.erb",
-    "spec/markaby/tilt/locals.mab",
-    "spec/markaby/tilt/markaby.mab",
-    "spec/markaby/tilt/markaby_other_static.mab",
-    "spec/markaby/tilt/render_twice.mab",
-    "spec/markaby/tilt/scope.mab",
-    "spec/markaby/tilt/yielding.mab",
-    "spec/markaby/tilt_spec.rb",
-    "spec/spec.opts",
-    "spec/spec_helper.rb"
-  ]
-  s.homepage = %q{http://markaby.github.com/markaby/}
-  s.require_paths = [%q{lib}]
-  s.rubygems_version = %q{1.8.6}
-  s.summary = %q{Markup as Ruby, write HTML in your native Ruby tongue}
-  if s.respond_to? :specification_version then
-    s.specification_version = 3
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<builder>, [">= 2.0.0"])
-    else
-      s.add_dependency(%q<builder>, [">= 2.0.0"])
-    end
-  else
-    s.add_dependency(%q<builder>, [">= 2.0.0"])
-  end
-end

data/markaby/README.rdoc DELETED

@@ -1,317 +0,0 @@
-= Markaby (Markup as Ruby)
-Markaby is a very short bit of code for writing HTML pages in pure Ruby.
-It is an alternative to ERb which weaves the two languages together.
-Also a replacement for templating languages which use primitive languages
-that blend with HTML.
-== Using Markaby as a Rails plugin / gem
-Write Rails templates in pure Ruby.  Example layout:
-  html do
-    head do
-      title 'Products: ' + action_name
-      stylesheet_link_tag 'scaffold'
-    end
-    body do
-      p flash[:notice], :style => "color: green"
-      div.signup! do
-        form_for @user do |f|
-          f.text_field :email
-        end
-      end
-      yield
-    end
-  end
-Markaby templates end in .mab
-Markaby supports many versions of rails, including the latest rails:
-  1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.2.6, 2.2.0,
-  2.2.1, 2.2.2, 2.2.3, 2.3.1, 2.3.2, 2.3.2.1,
-  2.3.3, 2.3.3.1, 2.3.4, 2.3.5, 2.3.6, 2.3.7,
-  2.3.8
-Rails 3.0 support is planned.
-=== Install it as a plugin
-  script/plugin install git://github.com/markaby/markaby.git
-=== Install it as a gem
-  gem install markaby
-If you are loading it in a different way (from a gem), make sure
-it's on the $LOAD_PATH, and add the following in
-an initializer (config/initializers/markaby.rb will work):
-  require 'markaby'
-  require 'markaby/rails'
-  Markaby::Rails.load
-Or, you could try config.gem, but that's now known as a bad idea.
-== Using Markaby with Sinatra (1.0+)
-  require 'markaby/sinatra'
-  get '/foo' do
-    mab :my_template # my_template.mab in the sinatra view path
-  end
-If you are looking for sinatra support pre 0.7, see http://github.com/sbfaulkner/sinatra-markaby
-== Using Markaby with other frameworks
-Tilt has a Markaby module, so in principle, any web framework that supports
-Tilt will also support Markaby.  See the appropriate tilt documentation:
-  http://github.com/rtomayko/tilt
-== Using Markaby as a Ruby class
-Markaby is flaming easy to call from your Ruby classes.
-  require 'markaby'
-  mab = Markaby::Builder.new
-  mab.html do
-    head { title "Boats.com" }
-    body do
-      h1 "Boats.com has great deals"
-      ul do
-        li "$49 for a canoe"
-        li "$39 for a raft"
-        li "$29 for a huge boot that floats and can fit 5 people"
-      end
-    end
-  end
-  puts mab.to_s
-Markaby::Builder.new does take two arguments for passing in variables and
-a helper object.  You can also affix the block right on to the class.
-See Markaby::Builder for all of that.
-= A Note About <tt>instance_eval</tt>
-The Markaby::Builder class is different from the normal Builder class,
-since it uses <tt>instance_eval</tt> when running blocks.  This cleans
-up the appearance of the Markaby code you write.  If <tt>instance_eval</tt>
-was not used, the code would look like this:
-  mab = Markaby::Builder.new
-  mab.html do
-    mab.head { mab.title "Boats.com" }
-    mab.body do
-      mab.h1 "Boats.com has great deals"
-    end
-  end
-  puts mab.to_s
-So, the advantage is the cleanliness of your code.  The disadvantage is that
-the block will run inside the Markaby::Builder object's scope.  This means
-that inside these blocks, <tt>self</tt> will be your Markaby::Builder object.
-When you use instance variables in these blocks, they will be instance variables
-of the Markaby::Builder object.
-This doesn't affect Rails users, but when used in regular Ruby code, it can
-be a bit disorienting.  You are recommended to put your Markaby code in a
-module where it won't mix with anything.
-= The Six Steps of Markaby
-If you dive right into Markaby, it'll probably make good sense, but you're
-likely to run into a few kinks.  Why not review these six steps and commit
-them memory so you can really *know* what you're doing?
-== 1. Element Classes
-Element classes may be added by hooking methods onto container elements:
-  div.entry do
-    h2.entryTitle 'Son of WebPage'
-    div.entrySection %{by Anthony}
-    div.entryContent 'Okay, once again, the idea here is ...'
-  end
-Which results in:
-  <div class="entry">
-    <h2 class="entryTitle">Son of WebPage</h2>
-    <div class="entrySection">by Anthony</div>
-    <div class="entryContent">Okay, once again, the idea here is ...</div>
-  </div>
-== 2. Element IDs
-IDs may be added by the use of bang methods:
-  div.page! {
-    div.content! {
-      h1 "A Short Short Saintly Dog"
-    }
-  }
-Which results in:
-  <div id="page">
-    <div id="content">
-      <h1>A Short Short Saintly Dog</h1>
-    </div>
-  </div>
-== 3. Validate Your XHTML 1.0 Output
-If you'd like Markaby to help you assemble valid XHTML documents,
-you can use the <tt>xhtml_transitional</tt> or <tt>xhtml_strict</tt>
-methods in place of the normal <tt>html</tt> tag.
-  xhtml_strict do
-    head { ... }
-    body { ... }
-  end
-This will add the XML instruction and the doctype tag to your document.
-Also, a character set meta tag will be placed inside your <tt>head</tt>
-tag.
-Now, since Markaby knows which doctype you're using, it checks a big
-list of valid tags and attributes before printing anything.
-  >> div :styl => "padding: 10px" do
-  >>   img :src => "samorost.jpg"
-  >> end
-  InvalidHtmlError: no such attribute `styl'
-Markaby will also make sure you don't use the same element ID twice!
-== 4. Escape or No Escape?
-Markaby uses a simple convention for escaping stuff: if a string
-is an argument, it gets escaped.  If the string is in a block, it
-doesn't.
-This is handy if you're using something like RedCloth or
-RDoc inside an element.  Pass the string back through the block
-and it'll skip out of escaping.
-  div.comment { RedCloth.new(str).to_html }
-But, if we have some raw text that needs escaping, pass it in
-as an argument:
-  div.comment raw_str
-One caveat: if you have other tags inside a block, the string
-passed back will be ignored.
-  div.comment {
-    div.author "_why"
-    div.says "Torpedoooooes!"
-    "<div>Silence.</div>"
-  }
-The final div above won't appear in the output.  You can't mix
-tag modes like that, friend.
-== 5. Auto-stringification
-If you end up using any of your Markaby "tags" as a string, the
-tag won't be output.  It'll be up to you to add the new string
-back into the HTML output.
-This means if you call <tt>to_s</tt>, you'll get a string back.
-  div.title { "Rock Bottom" + span(" by Robert Wyatt").to_s }
-But, when you're adding strings in Ruby, <tt>to_s</tt> happens automatically.
-  div.title { "Rock Bottom" + span(" by Robert Wyatt") }
-Interpolation works fine.
-  div.title { "Rock Bottom #{span(" by Robert Wyatt")}" }
-And any other operation you might perform on a string.
-  div.menu! \
-    ['5.gets', 'bits', 'cult', 'inspect', '-h'].map do |category|
-      link_to category
-    end.
-    join( " | " )
-== 6. The <tt>tag!</tt> Method
-If you need to force a tag at any time, call <tt>tag!</tt> with the
-tag name followed by the possible arguments and block.  The CssProxy
-won't work with this technique.
-  tag! :select, :id => "country_list" do
-    countries.each do |country|
-      tag! :option, country
-    end
-  end
-= A Note About Rails Helpers
-When used in Rails templates, the Rails helper object is passed into
-Markaby::Builder.  When you call helper methods inside Markaby, the output
-from those methods will be output to the stream.  This is incredibly
-handy, since most Rails helpers output HTML tags.
-  head do
-    javascript_include_tag 'prototype'
-    autodiscovery_link_tag
-  end
-However, some methods are designed to give back a String which you can use
-elsewhere.  That's okay!  Every method returns a Fragment object, which can
-be used as a string.
-  p { "Total is: #{number_to_human_size @file_bytes}" }
-Also see the Quick Tour above, specifically the stuff about auto-stringification.
-If for any reason you have trouble with fragments, you can just
-call the <tt>@helpers</tt> object with the method and you'll get
-the String back and nothing will be output.
-  p { "Total is: #{@helpers.number_to_human_size @file_bytes}" }
-Conversely, you may call instance variables from your controller by using
-a method and its value will be returned, nothing will be output.
-  # Inside imaginary ProductController
-  def list
-    @products = Product.find :all
-  end
-  # Inside app/views/product/list.mab
-  products.each do |product|
-    p product.title
-  end
-= Credits
-Markaby is a work of immense hope by Tim Fletcher and why the lucky stiff.
-It is maintained by joho, spox, and smtlaissezfaire.
-Thankyou for giving it a whirl.
-Markaby is inspired by the HTML library within cgi.rb.  Hopefully it will
-turn around and take some cues.
-== Patches from contributors:
-aredridel (Aria Stewart - aredridel@nbtsc.org)
-  - Make exceptions inherit from StandardError (f259c0)