michael_hintbuble 1.0.0

data/.gitignore

@@ -0,0 +1,2 @@
+.DS_Store
+*.gem

data/.specification

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification 
+name: michael_hintbuble
+version: !ruby/object:Gem::Version 
+  hash: 17
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 5
+  version: 0.1.5
+platform: ruby
+authors: 
+- Coroutine
+- Tim Lowrimore
+- John Dugan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-10 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: actionpack
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 2
+        - 3
+        - 4
+        version: 2.3.4
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 2
+        - 3
+        - 4
+        version: 2.3.4
+  type: :development
+  version_requirements: *id002
+description: Michael HintBuble allows you to generate hint bubbles and tooltips in Rails applications using the same syntax used for rendering templates.
+email: gems@coroutine.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- .specification
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- generators/michael_hintbuble/michael_hintbuble_generator.rb
+- generators/michael_hintbuble/templates/michael_hintbuble.css
+- generators/michael_hintbuble/templates/michael_hintbuble.js
+- generators/michael_hintbuble/templates/michael_hintbuble_pointer.png
+- init.rb
+- lib/generators/michael_hintbuble/michael_hintbuble_generator.rb
+- lib/generators/michael_hintbuble/templates/michael_hintbuble.css
+- lib/generators/michael_hintbuble/templates/michael_hintbuble.js
+- lib/generators/michael_hintbuble/templates/michael_hintbuble_pointer.png
+- lib/michael_hintbuble.rb
+- lib/michael_hintbuble/helpers.rb
+- michael_hintbuble.gemspec
+- rails/init.rb
+- test/michael_hintbuble/helpers_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/coroutine/michael_hintbuble
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Dead simple, beautiful hint bubbles for Rails.
+test_files: 
+- test/michael_hintbuble/helpers_test.rb
+- test/test_helper.rb
+

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Coroutine LLC
+
+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.rdoc

@@ -0,0 +1,201 @@
+= Michael Hintbuble
+
+Hiya.
+
+I'm Michael Hintbuble.  A lot of people confuse me with the singer who rose to fame singing jazz
+standards, but I'm a different guy altogether.  
+
+Don't get me wrong, that Michael and I are into a lot of the same things, like dating Emily Blunt and 
+opening fictitious restaurants with Jon Hamm. But while that Michael spent his career focused on smooth 
+vocal stylings and making ladies of all nationalities swoon, I only care about one thing.
+
+<b>Freakin' Hint Bubbles</b>.  
+
+If you're a Rails developer who wants to use hint bubbles but doesn't want to mess with Javascript, I
+suggest you get yourself a firmer grip on your knickers.
+
+Check it.  If you want my hint bubble anchored to an element in one of your views, here's what you do:
+
+    # Define the target
+    <div id="restaurant_header">Hamm and Buble</div>
+    
+    # Create and attach the bubble
+    <%= render_bubble :restaurant_header, 
+                      :position => :right, :event_names => [:mouseover], 
+                      :partial  => "map",  :locals      => { :address => @restaurant.address } %>
+
+That's pretty much it.  Did you notice how <tt>render_bubble</tt> takes the same options as 
+<tt>render</tt>?  The content for your bubble can just be a regular old partial.
+
+Boom.
+
+What's that, you want a few more details?  You got it, bro.
+
+<tt>render_bubble</tt> always needs the unique id for the target element as its first argument.  After 
+that, it will take the same options as <tt>ActionController::Base#render</tt>.  It'll also take a few 
+more, namely:
+
+* <tt>:class</tt> - the css style to assign to the outermost div container (defaults to "michael_hintbuble_bubble")
+* <tt>:style</tt> - additional css style assignments for the outermost div container (defaults to "")
+* <tt>:position</tt> - css-style value that specifies the hint bubble's relative position, e.g., top, bottom, right, or left (defaults to right)
+* <tt>:event_names</tt> - an array of strings specifying the events that should trigger the display of the hint bubble (accepts focus and/or mouseover)
+* <tt>:before_show</tt> - a Javascript function that will be invoked before the hint bubble is shown
+* <tt>:after_show</tt> - a Javascript function that will be invoked after the hint bubble has been shown
+* <tt>:before_hide</tt> - a Javascript function that will be invoked before the hint bubble is hidden
+* <tt>:after_hide</tt> - a Javascript function that will be invoked after the hint bubble has been hidden
+* <tt>&block</tt> - HTML markup that will be automatically converted to render's inline option
+
+Here's an example using the <tt>before_show</tt> option with block notation:
+
+    # Define the target
+    <div id="cry_for_help">I have a feeling that he's standing right behind me.</div>
+    
+    # Create and attach the bubble
+    <%= render_bubble :cry_for_help, :position => :bottom, :before_show => "function() { JonHamm.eyes.goBlack(); }" %>
+      <div>You are on the thinnest of ice.</div>
+    <% end %>
+
+If you need more help than that, maybe you should just look at the source code.  There are a ton of comments 
+in there.
+
+    
+Cheers,
+
+Michael Hintbuble
+
+
+
+== Multiple Hint Bubble Styles
+
+If you need to style more than one kind of hint bubble (e.g., one style for tooltips, one style for errors), just
+use the <tt>:class</tt> option to set a new css class name on the outermost div.  That'll give you a logical anchor 
+around which you can restyle all the interior classes.
+
+Please note that the blocking iframe is automatically given a class name equal to the outermost div's class name plus 
+the string "_frame".  
+
+By default, the top-level class assignments are "michael_hintbuble_bubble" and "michael_hintbuble_bubble_frame". 
+
+If you set the <tt>:class</tt> option to <tt>:error_bubble</tt>, the top-level class assignments will be 
+"error_bubble" and "errorbubble_frame".
+
+The <tt>:style</tt> option can be used to provide one-off styling, as needed.
+
+
+
+== Positioning Notes
+
+Windows get resized, documents and divs scroll, stuff happens.  Sometimes the area in which you intended for a 
+hint bubble to appear ends up off the viewport.  Which kind of screws the whole hint bubble UI pattern.
+
+Good thing I'm so friendly.  Here's what I can do to help.  
+
+If you tell me to position the bubble to one side of the target and the bubble can't fit in the viewport over 
+there, I'll just place it on the opposite side.  If it doesn't fit over there either, I'll just give up and
+put it where you told me in the first place.  I'm not a mindreader, you know.
+
+
+
+== IE6 Support
+
+I'm not what you'd call a huge fan of IE6, so I don't provide a blocking 
+iframe for my hint bubbles by default.  But I can.  You just need to ask nicely.
+
+At the top of the generated javascript file, just change the obviously-named property 
+hanging	right off of the main namespace.  Like this.
+
+	MichaelHintbuble.SUPPORT_IE6_BULLSHIT = true;
+
+That's it. I do the rest.
+
+
+
+== Helpful Links
+
+* <b>Repository:</b> http://github.com/coroutine/michael_hintbuble
+* <b>Gem:</b> http://rubygems.org/gems/michael_hintbuble
+* <b>Authors:</b> http://coroutine.com
+
+
+
+== Prerequisites
+
+If you want to come fly with me, you'll need to invite the other members of my trio, Prototype and Scriptaculous.  
+
+But since I was designed as a Rails extension, chances are you already have my bandmates
+in the mix.
+
+* <b>Prototype:</b> http://prototypejs.org
+* <b>Scriptaculous:</b> http://script.aculo.us
+
+
+
+== Installation & Generators (Rails 2)
+
+Install me from RubyGems.org and add a gem dependency in the appropriate file.
+
+	$ gem install michael_hintbuble
+
+Or install me as a plugin.
+
+	$ script/plugin install git://github.com/coroutine/michael_hintbuble.git
+
+Either way, then generate the required javascript file and the starter 
+stylesheet and image.
+
+	$ script/generate michael_hintbuble
+
+
+
+== Installation & Generators (Rails 3)
+
+Install me from RubyGems.org by adding a gem dependency to your Gemfile.  Bundler does 
+the rest.
+
+	gem "michael_hintbuble"
+	
+	$ bundle install
+
+Then generate the required javascript file and the starter stylesheet and image.
+
+	$ rails g michael_hintbuble
+	
+
+
+== Gemroll
+
+If you think I'm awesome, you should check out my soulmate 
+{Kenny Dialoggins}[http://github.com/coroutine/kenny_dialoggins].
+
+Other gems by Coroutine include:
+
+* {acts_as_current}[http://github.com/coroutine/acts_as_current]
+* {acts_as_label}[http://github.com/coroutine/acts_as_label]
+* {acts_as_list_with_sti_support}[http://github.com/coroutine/acts_as_list_with_sti_support]
+* {delayed_form_observer}[http://github.com/coroutine/delayed_form_observer]
+* {tiny_navigation}[http://github.com/coroutine/tiny_navigation]
+
+
+
+== License
+
+Copyright (c) 2010 {Coroutine LLC}[http://coroutine.com].
+
+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/Rakefile

@@ -0,0 +1,49 @@
+require "rake"
+require "rake/testtask"
+require "rake/rdoctask"
+require "jeweler"
+
+
+desc "Default: run tests."
+task :default => [:test]
+
+
+desc "Test the plugin."
+Rake::TestTask.new(:test) do |t|
+  t.libs    << "lib"
+  t.pattern  = "test/**/*_test.rb"
+  t.verbose  = true
+end
+
+
+desc "Generate documentation for the plugin."
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = "rdoc"
+  rdoc.title    = "michael_hintbuble"
+  rdoc.options << "--line-numbers --inline-source"
+  rdoc.rdoc_files.include("README")
+  rdoc.rdoc_files.include("lib/**/*.rb")
+end
+
+
+begin
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.authors           = ["Coroutine", "Tim Lowrimore", "John Dugan"]
+    gemspec.description       = "Michael HintBuble allows you to generate hint bubbles and tooltips in Rails applications using the same syntax used for rendering templates."
+    gemspec.email             = "gems@coroutine.com"
+    gemspec.homepage          = "http://github.com/coroutine/michael_hintbuble"
+    gemspec.name              = "michael_hintbuble"
+    gemspec.summary           = "Dead simple, beautiful hint bubbles for Rails."
+    
+    gemspec.add_dependency("actionpack", ">=2.3.4")
+    gemspec.add_development_dependency("activesupport", ">=2.3.4")
+    
+    gemspec.files.include("generators/**/*", "lib/**/*")
+    gemspec.files.include("test/**/*")
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/generators/michael_hintbuble/michael_hintbuble_generator.rb

@@ -0,0 +1,13 @@
+class MichaelHintbubleGenerator < Rails::Generator::Base
+
+  # This method copies stylesheet and javascript files to the 
+  # corresponding public directories.
+  #
+  def manifest
+    record do |m|
+      m.file "michael_hintbuble_pointer.png", "public/images/michael_hintbuble_pointer.png"
+      m.file "michael_hintbuble.css",         "public/stylesheets/michael_hintbuble.css"
+      m.file "michael_hintbuble.js",          "public/javascripts/michael_hintbuble.js"
+    end
+  end
+end

data/generators/michael_hintbuble/templates/michael_hintbuble.css

@@ -0,0 +1,48 @@
+/**  
+ * These styles are provided as examples. Feel free to change them however you like. 
+ * Go ahead, see if we fucking care.
+ */
+
+.michael_hintbuble_bubble_frame {
+    position: absolute;
+    border: none;
+    z-index: 1;
+    filter: alpha(opacity=0);                           /* really only needed if ie6 suport is enabled */
+}
+
+.michael_hintbuble_bubble {                   
+    position: absolute;
+    top: 0;
+    left: 0;
+    z-index: 2;
+    filter: alpha(opacity=100);                         /* really only needed if ie6 suport is enabled */
+    width: 240px;
+}
+.michael_hintbuble_bubble .container {
+    margin: 2px;
+    padding: 8px;
+    font-size: .85em;
+}
+.michael_hintbuble_bubble .container .content {
+    padding:                8px;
+    background:             #333;
+    color:                  #FFF;
+    border-radius:          2px;
+    -moz-border-radius:     2px;
+    -webkit-border-radius:  2px;
+}
+.michael_hintbuble_bubble .bottom,               
+.michael_hintbuble_bubble .left,
+.michael_hintbuble_bubble .right,
+.michael_hintbuble_bubble .top {
+    background: url('../images/michael_hintbuble_pointer.png') no-repeat bottom;
+}
+.michael_hintbuble_bubble .bottom {
+    background-position: top;
+}
+.michael_hintbuble_bubble .left {
+    background-position: right;
+}
+.michael_hintbuble_bubble .right {
+    background-position: left;
+}