gallerby 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,23 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+.yardoc
+doc
+pkg
+
+## PROJECT::SPECIFIC
+.sass-cache

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Waine Kerr
+
+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/README.md

@@ -0,0 +1,61 @@
+gallerby
+========
+
+Think about a dead-simple static gallery generator, with nothing except pictures, thumbnails, previews. A kind of server directory listing for pictures. Enter Gallerby!
+
+An example of a gallerby-generated gallery can be found [here]("http://wainekerr.github.com/gallerby").
+
+## Installation
+
+Classic!
+
+  `(sudo) gem install gallerby`
+
+## Usage
+
+Before building your gallery, you have to respect this kind of "directory model" :
+
+  name_of_my_gallery/ <---- This is where you gallery will reside.
+    originals/        <---- This is where you have to put your pictures.
+    thumbnails/       <---- This is where Gallerby will create thumbnails for you.
+    previews/         <---- This is where Gallerby will store "middle-sized" versions of your pictures for Lightbox.
+
+When your directory is ready :
+
+  `gallerby -d directory_of_my_gallery`
+
+Wait, and tada!
+
+## Moar Usage
+
+If I was an asshole, i'd say you to RTFM. So :
+
+  $ gallerby -h
+  gallerby - frakin' dead simple gallery generator
+  
+  Usage: gallerby -d [directory] [options]
+  
+  Options are:
+      -d, --directory DIRECTORY        Directory of the Gallery
+      -n, --name [NAME]                Name (optional, default to directory)
+      -s, --summary [SUMMARY]          Summary (optional, default empty)
+      -p, --per-page [PER_PAGE]        Pictures to display per page (default is 20)
+      -h, --help                       RTFM, dude!
+
+## Updating
+
+You can re-run `gallerby` to an existing gallery. It'll skip thumbnails & previews creation if files already exists.
+
+Currently, no parameters are stored (like custom name, description, pictures per page). It's planned.
+
+## Copyright
+
+Copyright (c) 2010 Waine Kerr.
+
+Released under the terms of the MIT license, see LICENSE for details.
+
+Please note that other software is included in gallerby and may be released under others licenses:
+
+* [Prototype]("http://github.com/sstephenson/prototype"), Copyright (c) 2005-2010 Sam Stephenson
+* [script.aculo.us]("http://github.com/madrobby/scriptaculous"), Copyright (c) 2005-2010 Thomas Fuchs
+* [Lightbox]("http://huddletogether.com/projects/lightbox2"), by Lokesh Dhakar

data/Rakefile

@@ -0,0 +1,55 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "gallerby"
+    gem.summary = %Q{Think about a webserver directory-listing for pictures.}
+    gem.description = %Q{Think about a dead-simple static gallery generator, with nothing except pictures, thumbnails, previews. A kind of server directory listing for pictures. Enter Gallerby!}
+    gem.email = "wk@heldscalla.org"
+    gem.homepage = "http://github.com/wainekerr/gallerby"
+    gem.authors = ["Waine Kerr"]
+    gem.executables = %w(gallerby)
+    gem.add_dependency "mini_magick", ">= 2.0.0"
+    gem.add_dependency "haml", ">= 3.0.17"
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    gem.add_development_dependency "yard", ">= 0"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/gallerby

@@ -0,0 +1,77 @@
+#!/usr/bin/env ruby
+#
+# Runner for Gallerby
+
+require 'ostruct'
+require 'optparse'
+require 'optparse/time'
+
+lib_dir = File.dirname(__FILE__) + '/../lib/'
+require File.dirname(__FILE__) + '/../lib/gallerby'
+
+options = {:per_page=>20}
+
+optparse = OptionParser.new do |opts|
+  opts.banner = <<BANNER
+gallerby - frakin' dead simple gallery generator
+
+Usage: #{File.basename($0)} -d [directory] [options]
+
+Options are:
+BANNER
+
+  opts.on_tail('-h', '--help', 'RTFM, dude!') do
+    puts opts
+    exit 1
+  end
+  
+  opts.on('-d DIRECTORY', '--directory DIRECTORY', "Directory of the Gallery") do |f|
+    options[:directory] = f
+  end
+  
+  opts.on('-n', '--name [NAME]', 'Name (optional, default to directory)') do |f|
+    options[:name] = f || options[:directory]
+  end
+  
+  opts.on('-s', '--summary [SUMMARY]', 'Summary (optional, default empty)') do |f|
+    options[:summary] = f || ""
+  end
+  
+  opts.on('-p', '--per-page [PER_PAGE]', Integer, 'Pictures to display per page (default is 20)') do |f|
+    options[:per_page] = f || 20
+  end
+end
+
+begin # From http://stackoverflow.com/questions/1541294/how-do-you-specify-a-required-switch-not-argument-with-ruby-optionparser/2149183#2149183
+  optparse.parse!                                                                                                                                                                                                 
+  mandatory = [:directory]
+  missing = mandatory.select{ |param| options[param].nil? }
+  if not missing.empty?
+    puts optparse
+    exit 1
+  end
+rescue OptionParser::InvalidOption, OptionParser::MissingArgument
+  puts optparse
+  exit 1
+end
+
+begin
+  g = Gallerby.new(options[:directory], options[:per_page], options[:name], options[:summary])
+  g.verify_directory_structure
+  g.scan_pictures
+  puts "[WARNING ] Found 0 pictures in #{g.originals}. Your gallery will be empty!" if g.pictures.size == 0
+  g.map_pages
+  puts "[INFO    ] Your gallery will have #{g.pictures.size} pictures in #{g.pages.size} pages."
+  print "[BUILDING] Thumbnails: " ; STDOUT.flush
+  g.build_thumbnails
+  print "[BUILDING] Previews: " ; STDOUT.flush
+  g.build_previews
+  puts "[INFO    ] Copying assets and building CSS to #{g.directory}/assets"
+  g.copy_and_build_assets
+  print "[BUILDING] HTML: " ; STDOUT.flush
+  g.build_gallery
+  puts "[HOORAY  ] Your gallery have been successfully builded. Enjoy \\o/"
+rescue
+  puts "[OH NOES ] #{$!}"
+  exit 1
+end

data/gallerby.gemspec

@@ -0,0 +1,82 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{gallerby}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Waine Kerr"]
+  s.date = %q{2010-08-22}
+  s.default_executable = %q{gallerby}
+  s.description = %q{Think about a dead-simple static gallery generator, with nothing except pictures, thumbnails, previews. A kind of server directory listing for pictures. Enter Gallerby!}
+  s.email = %q{wk@heldscalla.org}
+  s.executables = ["gallerby"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.md"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.md",
+     "Rakefile",
+     "VERSION",
+     "bin/gallerby",
+     "gallerby.gemspec",
+     "lib/gallerby.rb",
+     "lib/shared/assets/css/lightbox.css",
+     "lib/shared/assets/img/bullet.gif",
+     "lib/shared/assets/img/close.gif",
+     "lib/shared/assets/img/closelabel.gif",
+     "lib/shared/assets/img/donate-button.gif",
+     "lib/shared/assets/img/download-icon.gif",
+     "lib/shared/assets/img/loading.gif",
+     "lib/shared/assets/img/nextlabel.gif",
+     "lib/shared/assets/img/prevlabel.gif",
+     "lib/shared/assets/js/builder.js",
+     "lib/shared/assets/js/effects.js",
+     "lib/shared/assets/js/lightbox.js",
+     "lib/shared/assets/js/prototype.js",
+     "lib/shared/assets/js/scriptaculous.js",
+     "lib/shared/templates/gallerby.haml",
+     "lib/shared/templates/gallerby.sass",
+     "test/helper.rb",
+     "test/test_gallerby.rb"
+  ]
+  s.homepage = %q{http://github.com/wainekerr/gallerby}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Think about a webserver directory-listing for pictures.}
+  s.test_files = [
+    "test/helper.rb",
+     "test/test_gallerby.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<mini_magick>, [">= 2.0.0"])
+      s.add_runtime_dependency(%q<haml>, [">= 3.0.17"])
+      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<mini_magick>, [">= 2.0.0"])
+      s.add_dependency(%q<haml>, [">= 3.0.17"])
+      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<mini_magick>, [">= 2.0.0"])
+    s.add_dependency(%q<haml>, [">= 3.0.17"])
+    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end
+

data/lib/gallerby.rb

@@ -0,0 +1,139 @@
+%w{fileutils mini_magick haml sass}.each {|r| require r }
+
+class Gallerby
+  PICTURES_MATCHER = "*.{jpg,jpeg,JPG,JPEG,gif,GIF,png,PNG}"
+  SHARED_PATH = File.expand_path('../shared', __FILE__)
+  HAML_OPTS = {:format => :html5, :escape_html => true}
+  SASS_OPTS = {}
+  attr_accessor :directory, :name, :pictures, :originals, :pages, :description, :pages_links
+  
+  # Well... initialize the Gallerby.
+  #
+  # @param [String] directory string of the gallery root directory
+  # @param [optional, Integer] per_page number of pictures to display per page
+  # @param [optional, String] name custom name for the gallery (default is the directory)
+  # @param [optional, String] description description for the gallery (default is nothing)
+  # @raise [RuntimeError] if gallery directory don't exists or don't match the required structure.
+  def initialize(directory, per_page=20, name=nil, description=nil)
+    @directory, @per_page, @name, @description = directory, per_page, name, description
+    @thumbs, @previews, @originals = "#{@directory}/thumbnails", "#{@directory}/previews", "#{@directory}/originals"
+    raise "Directory #{@directory} don't exists." unless File.exists?(@directory)
+  end
+  
+  # Verify if the directory structure match the gallerby requirements. See the README for more information
+  #
+  # @return [TrueClass, FalseClass]
+  def verify_directory_structure
+    raise "Thumbnails directory (#{@thumbs}) don't exist." unless File.exists?(@thumbs)
+    raise "Previews directory (#{@previews}) don't exist." unless File.exists?(@previews)
+    raise "Originals directory (#{@originals}) don't exist." unless File.exists?(@originals)
+  end
+  
+  # Scan for pictures in the original directory.
+  # @returns [Array] Filenames of the pictures
+  def scan_pictures
+    @pictures = Dir["#{@originals}/#{PICTURES_MATCHER}"]
+  end
+  
+  # Map pages/pictures for pagination purposes
+  #
+  # @returns [Hash] Pages ID & Pictures associated to the page.
+  def map_pages
+    @pages = {}
+    page_id = 0
+    pict_count = 0
+    page_pictures = []
+    
+    @pictures.each do |picture|
+      if pict_count == @per_page
+        @pages[page_id] = page_pictures
+        page_pictures = []
+        page_id += 1
+        pict_count = 0
+      end
+      page_pictures << picture
+      pict_count += 1
+    end
+    
+    @pages
+  end
+  
+  # Build the thumbnails
+  #
+  # @see Gallerby#the_rezise_machine
+  def build_thumbnails(size="200x200", verbose=true)
+    the_resize_machine(@pictures, @thumbs, size, verbose)
+  end
+  
+  # Build the previews
+  #
+  # @see Gallerby#the_rezise_machine
+  def build_previews(size="900x780", verbose=true)
+    the_resize_machine(@pictures, @previews, size, verbose)
+  end
+  
+  # Copy the assets (JS, CSS and images) to the gallery directory, and build the CSS.
+  def copy_and_build_assets
+    FileUtils.cp_r("#{SHARED_PATH}/assets", @directory)
+    sass = Sass::Engine.new(File.read("#{SHARED_PATH}/templates/gallerby.sass"), SASS_OPTS).to_css
+    File.open("#{@directory}/assets/css/gallerby.css", 'w') {|f| f.write(sass) }
+  end
+  
+  # Build all HTML pages of the gallery.
+  #
+  # @see Gallerby#build_page
+  def build_gallery(verbose=true)
+    @pages_links = {}
+    @pages.each do |page_id,pictures|
+      page_name = page_id==0 ? "index" : "page#{page_id}"
+      build_page(page_id, page_name, pictures)
+      (print "." ; STDOUT.flush) if verbose
+    end
+    (print " OK!\n" ; STDOUT.flush) if verbose
+  end
+  
+  # Helper to build the navigations links
+  def navigation_links(current_page)
+    links = "Pages:&nbsp;"
+    @pages.keys.sort.each do |pid|
+      page_link = pid==0 ? "index.html" : "page#{pid}.html"
+      extra_html = pid==current_page ? " class='selected'" : ""
+      links << "<a href='#{page_link}' title='Page #{pid+1}'#{extra_html}>#{pid+1}</a>&nbsp;"
+    end
+    links
+  end
+  
+  private
+  # Build a page of the gallery.
+  #
+  # @params [Integer] pid ID of the page
+  # @params [String] pname Name of the page (index or pageID)
+  # @picts [Array] Array of pictures path
+  def build_page(pid, pname, picts)
+    page_pictures = []
+    picts.each {|pict| page_pictures << pict.gsub("#{@originals}/", '') }
+    locals = {:gallery => self, :pid => pid, :pname => pname, :pictures => page_pictures}
+    haml = Haml::Engine.new(File.read("#{SHARED_PATH}/templates/gallerby.haml"), HAML_OPTS).render(Object.new, locals)
+    File.open("#{@directory}/#{pname}.html", 'w') {|f| f.write(haml) }
+  end
+  
+  # Resize an Array of pictures
+  #
+  # @params [Array] pictures Array of pictures path
+  # @params [String] save_path in which directory to save the picture
+  # @params [String] size Size to use for rezising.
+  # @params [Boolean] verbose Enable verbose or not (useful for `gallerby` binary)
+  def the_resize_machine(pictures, save_path, size, verbose)
+    pictures.each do |picture|
+      read_from = "#{picture}"
+      write_to = "#{save_path}#{picture.gsub(@originals, '')}"
+      unless File.exists?(write_to)
+        magick = MiniMagick::Image.from_file(read_from)
+        magick.resize(size)
+        magick.write(write_to)
+        (print "." ; STDOUT.flush) if verbose
+      end
+    end
+    (print " OK!\n" ; STDOUT.flush) if verbose
+  end
+end

data/lib/shared/assets/css/lightbox.css

@@ -0,0 +1,27 @@
+#lightbox{	position: absolute;	left: 0; width: 100%; z-index: 100; text-align: center; line-height: 0;}
+#lightbox img{ width: auto; height: auto;}
+#lightbox a img{ border: none; }
+
+#outerImageContainer{ position: relative; background-color: #fff; width: 250px; height: 250px; margin: 0 auto; }
+#imageContainer{ padding: 10px; }
+
+#loading{ position: absolute; top: 40%; left: 0%; height: 25%; width: 100%; text-align: center; line-height: 0; }
+#hoverNav{ position: absolute; top: 0; left: 0; height: 100%; width: 100%; z-index: 10; }
+#imageContainer>#hoverNav{ left: 0;}
+#hoverNav a{ outline: none;}
+
+#prevLink, #nextLink{ width: 49%; height: 100%; background-image: url(data:image/gif;base64,AAAA); /* Trick IE into showing hover */ display: block; }
+#prevLink { left: 0; float: left;}
+#nextLink { right: 0; float: right;}
+#prevLink:hover, #prevLink:visited:hover { background: url(../img/prevlabel.gif) left 15% no-repeat; }
+#nextLink:hover, #nextLink:visited:hover { background: url(../img/nextlabel.gif) right 15% no-repeat; }
+
+#imageDataContainer{ font: 10px Verdana, Helvetica, sans-serif; background-color: #fff; margin: 0 auto; line-height: 1.4em; overflow: auto; width: 100%	; }
+
+#imageData{	padding:0 10px; color: #666; }
+#imageData #imageDetails{ width: 70%; float: left; text-align: left; }	
+#imageData #caption{ font-weight: bold;	}
+#imageData #numberDisplay{ display: block; clear: left; padding-bottom: 1.0em;	}			
+#imageData #bottomNavClose{ width: 66px; float: right;  padding-bottom: 0.7em; outline: none;}	 	
+
+#overlay{ position: absolute; top: 0; left: 0; z-index: 90; width: 100%; height: 500px; background-color: #000; }

data/lib/shared/assets/js/builder.js

@@ -0,0 +1,136 @@
+// script.aculo.us builder.js v1.8.1, Thu Jan 03 22:07:12 -0500 2008
+
+// Copyright (c) 2005-2007 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
+//
+// script.aculo.us is freely distributable under the terms of an MIT-style license.
+// For details, see the script.aculo.us web site: http://script.aculo.us/
+
+var Builder = {
+  NODEMAP: {
+    AREA: 'map',
+    CAPTION: 'table',
+    COL: 'table',
+    COLGROUP: 'table',
+    LEGEND: 'fieldset',
+    OPTGROUP: 'select',
+    OPTION: 'select',
+    PARAM: 'object',
+    TBODY: 'table',
+    TD: 'table',
+    TFOOT: 'table',
+    TH: 'table',
+    THEAD: 'table',
+    TR: 'table'
+  },
+  // note: For Firefox < 1.5, OPTION and OPTGROUP tags are currently broken,
+  //       due to a Firefox bug
+  node: function(elementName) {
+    elementName = elementName.toUpperCase();
+    
+    // try innerHTML approach
+    var parentTag = this.NODEMAP[elementName] || 'div';
+    var parentElement = document.createElement(parentTag);
+    try { // prevent IE "feature": http://dev.rubyonrails.org/ticket/2707
+      parentElement.innerHTML = "<" + elementName + "></" + elementName + ">";
+    } catch(e) {}
+    var element = parentElement.firstChild || null;
+      
+    // see if browser added wrapping tags
+    if(element && (element.tagName.toUpperCase() != elementName))
+      element = element.getElementsByTagName(elementName)[0];
+    
+    // fallback to createElement approach
+    if(!element) element = document.createElement(elementName);
+    
+    // abort if nothing could be created
+    if(!element) return;
+
+    // attributes (or text)
+    if(arguments[1])
+      if(this._isStringOrNumber(arguments[1]) ||
+        (arguments[1] instanceof Array) ||
+        arguments[1].tagName) {
+          this._children(element, arguments[1]);
+        } else {
+          var attrs = this._attributes(arguments[1]);
+          if(attrs.length) {
+            try { // prevent IE "feature": http://dev.rubyonrails.org/ticket/2707
+              parentElement.innerHTML = "<" +elementName + " " +
+                attrs + "></" + elementName + ">";
+            } catch(e) {}
+            element = parentElement.firstChild || null;
+            // workaround firefox 1.0.X bug
+            if(!element) {
+              element = document.createElement(elementName);
+              for(attr in arguments[1]) 
+                element[attr == 'class' ? 'className' : attr] = arguments[1][attr];
+            }
+            if(element.tagName.toUpperCase() != elementName)
+              element = parentElement.getElementsByTagName(elementName)[0];
+          }
+        } 
+
+    // text, or array of children
+    if(arguments[2])
+      this._children(element, arguments[2]);
+
+     return element;
+  },
+  _text: function(text) {
+     return document.createTextNode(text);
+  },
+
+  ATTR_MAP: {
+    'className': 'class',
+    'htmlFor': 'for'
+  },
+
+  _attributes: function(attributes) {
+    var attrs = [];
+    for(attribute in attributes)
+      attrs.push((attribute in this.ATTR_MAP ? this.ATTR_MAP[attribute] : attribute) +
+          '="' + attributes[attribute].toString().escapeHTML().gsub(/"/,'&quot;') + '"');
+    return attrs.join(" ");
+  },
+  _children: function(element, children) {
+    if(children.tagName) {
+      element.appendChild(children);
+      return;
+    }
+    if(typeof children=='object') { // array can hold nodes and text
+      children.flatten().each( function(e) {
+        if(typeof e=='object')
+          element.appendChild(e)
+        else
+          if(Builder._isStringOrNumber(e))
+            element.appendChild(Builder._text(e));
+      });
+    } else
+      if(Builder._isStringOrNumber(children))
+        element.appendChild(Builder._text(children));
+  },
+  _isStringOrNumber: function(param) {
+    return(typeof param=='string' || typeof param=='number');
+  },
+  build: function(html) {
+    var element = this.node('div');
+    $(element).update(html.strip());
+    return element.down();
+  },
+  dump: function(scope) { 
+    if(typeof scope != 'object' && typeof scope != 'function') scope = window; //global scope 
+  
+    var tags = ("A ABBR ACRONYM ADDRESS APPLET AREA B BASE BASEFONT BDO BIG BLOCKQUOTE BODY " +
+      "BR BUTTON CAPTION CENTER CITE CODE COL COLGROUP DD DEL DFN DIR DIV DL DT EM FIELDSET " +
+      "FONT FORM FRAME FRAMESET H1 H2 H3 H4 H5 H6 HEAD HR HTML I IFRAME IMG INPUT INS ISINDEX "+
+      "KBD LABEL LEGEND LI LINK MAP MENU META NOFRAMES NOSCRIPT OBJECT OL OPTGROUP OPTION P "+
+      "PARAM PRE Q S SAMP SCRIPT SELECT SMALL SPAN STRIKE STRONG STYLE SUB SUP TABLE TBODY TD "+
+      "TEXTAREA TFOOT TH THEAD TITLE TR TT U UL VAR").split(/\s+/);
+  
+    tags.each( function(tag){ 
+      scope[tag] = function() { 
+        return Builder.node.apply(Builder, [tag].concat($A(arguments)));  
+      } 
+    });
+  }
+}