css_tt 0.0.3

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 [name of plugin creator]
+
+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,60 @@
+= CssTt
+
+CssTt provides a simple way for creating pure css based tooltips. It was inspired by Alexander Dawson post http://sixrevisions.com/css/css-only-tooltips/ and some Alex Hall improvements http://www.devseo.co.uk/examples/pure-css-tooltips/, so I just wraped that up to a simple Rails plugin.
+
+== Instalation
+
+  (sudo) gem install css_tt
+
+Then
+  script/generate css_tt
+which will generate css files and copy icon images to your public dir.
+
+You will also need to add css to any layout header you will use css_tt in.
+  <%= stylesheet_link_tag 'css_tt' %>
+or
+  <%= stylesheet_link_tag 'application', 'your_css_files', 'css_tt', :cache => 'cached_css' %>
+and add
+  config.gem "css_tt"
+in your environment.rb file
+
+== Example
+
+css_tt() helper method returns a html markup which with help of css makes tooltips for given string
+
+Use helper in your views e.g.: 
+  <%= css_tt("I am text to be explained on hover", "I am the text in tooltip") %>
+This will generate a classic popup
+
+Some options are available for tooltips, like :type, :transition and :title
+- :type => possible options are :classic, :critical, :help, :warning an :info. Type defines the look of the tooltip and if other than classic adds an icon. Types are quite self explainable
+- :transition => works only for webkit based browsers (i.e. Chrome, Safari), but is unobtrusive and does nothing on other browsers, because it's css based
+- :title => tootip title, optional
+
+You can use tooltips for whatever inline html element you want and add any 
+inline elements inside the tooltip.
+  <%= css_tt(link_to(smth, path), 
+          "<b>find</b> more #{link_to('here', path)}", 
+          :type => :info,
+          :title => "Outside link",
+          :transition => :left) %>
+          
+How do these look like http://www.devseo.co.uk/examples/pure-css-tooltips/
+          
+== Future
+
+In the future I expect to add more optional tooltip styles to css_tt
+
+== TODO
+
+* Tutorial-like demo page
+* Option to add css file link tag to layout file while generating
+* Add more fancy stuff
+
+== Collaboration 
+
+If you are a good designer, have some css styles for tooltips and want them in this gem, pm me http://github.com/medwezys.
+Keep in mind that the structure of tooltip styles should be simmilar i.e. types - classic, info, warning, critical, help and so on. These are defined using css classes. More info in Alexander Dawson post http://sixrevisions.com/css/css-only-tooltips/
+
+Copyright (c) 2010 Tadas Tamosauskas, Alexander Dawson, Alex Hall. 
+Released under the MIT license

data/Rakefile

@@ -0,0 +1,33 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+
+# PKG_FILES = FileList[
+#   '[a-zA-Z]*',
+#   'generators/**/*',
+#   'lib/**/*',
+#   'rails/**/*',
+#   'tasks/**/*',
+#   'test/**/*'
+# ]
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the css_tt plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the css_tt plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'CssTt'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/css_tt.gemspec

@@ -0,0 +1,60 @@
+Gem::Specification.new do |s|
+  
+  PKG_FILES = %w[
+    css_tt.gemspec
+    generators
+    install.rb
+    lib
+    MIT-LICENSE
+    pkg
+    rails
+    Rakefile
+    rdoc
+    README.rdoc
+    tasks
+    test
+    uninstall.rb
+    generators/css_tt
+    generators/css_tt/css_tt_generator.rb
+    generators/css_tt/templates
+    generators/css_tt/templates/critical.png
+    generators/css_tt/templates/css_tt.css
+    generators/css_tt/templates/help.png
+    generators/css_tt/templates/info.png
+    generators/css_tt/templates/warning.png
+    generators/css_tt/USAGE
+    lib/css_tt.rb
+    rails/init.rb
+    tasks/css_tt_tasks.rake
+    test/css_tt_test.rb
+    test/test_helper.rb
+  ]
+  
+  s.name = %q{css_tt}
+  s.version = "0.0.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tadas Tamosauskas", "Alexander Dawson", "Alex Hall"]
+  s.date = %q{2010-06-20}
+  s.description = %q{Dead simple pure CSS based tooltips for Rails}
+  s.email = %q{tadastoo@yahoo.com}
+  s.extra_rdoc_files = ["README.rdoc"]
+  s.files = PKG_FILES.to_a
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/medwezys/css_tt}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "CssTt", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Dead simple pure CSS based tooltips for Rails.}
+  s.platform = Gem::Platform::RUBY
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if current_version >= 3 then
+    else
+    end
+  else
+  end
+end

data/generators/css_tt/USAGE

@@ -0,0 +1,11 @@
+Usage:
+    script/generate css_tt
+
+  This will create:
+      
+    # static files
+      public/stylesheets/css_tt.css
+      public/images/css_tt/info.png
+      public/images/css_tt/help.png
+      public/images/css_tt/warning.png
+      public/images/css_tt/critical.png

data/generators/css_tt/css_tt_generator.rb

@@ -0,0 +1,23 @@
+class CssTtGenerator < Rails::Generator::Base
+  
+  def manifest
+    record do |m|
+      # css file
+      m.file "css_tt.css", "public/stylesheets/css_tt.css"
+      
+      # images
+      img_dir = "public/images/css_tt"
+      m.directory img_dir
+      
+      # %(info warning critical help).each do |img|
+      #   m.file "#{img}.txt", File.join(img_dir, "#{img}.txt")
+      # end
+      m.file "info.png", File.join(img_dir, "info.png")
+      m.file "warning.png", File.join(img_dir, "warning.png")
+      m.file "critical.png", File.join(img_dir, "critical.png")
+      m.file "help.png", File.join(img_dir, "help.png")
+      
+    end
+  end
+
+end

data/generators/css_tt/templates/css_tt.css

@@ -0,0 +1,79 @@
+.css_tt_hoverable {
+  border-bottom: 1px dotted #000;
+  color: #000;
+  outline: none;
+  cursor: help;
+  text-decoration: none;
+  position: relative;
+}
+.css_tt_hoverable span {
+  position: absolute;
+  top: 2em;
+  left: 1em;
+  width: 250px;
+  margin-left: -99em;
+  opacity: 0;
+
+  border-radius: 5px;
+  -moz-border-radius: 5px;
+  -webkit-border-radius: 5px;
+
+  box-shadow: 2px 2px 10px rgba(0,0,0,0.4);
+  -webkit-box-shadow: 2px 2px 10px rgba(0,0,0,0.4);
+  -moz-box-shadow: 2px 2px 10px rgba(0,0,0,0.4);
+
+  -moz-transition-property: opacity;
+  -moz-transition-duration: 1s;
+  -webkit-transition-property: opacity;
+  -webkit-transition-duration: 1s;
+  -o-transition-property: opacity;
+  -o-transition-duration: 1s;
+}
+.css_tt_hoverable.css_tt_left span {
+  -moz-transition-property: opacity, margin-left, left;
+  -moz-transition-duration: 1s;
+  -webkit-transition-property: opacity, margin-left, left;
+  -webkit-transition-duration: 1s;
+  -o-transition-property: opacity, margin-left, left;
+  -o-transition-duration: 1s;
+}
+.css_tt_hoverable.css_tt_top span {
+  top: -99em;
+  margin-left: auto;
+
+  -moz-transition-property: opacity, top;
+  -moz-transition-duration: 1s;
+  -webkit-transition-property: opacity, top;
+  -webkit-transition-duration: 1s;
+  -o-transition-property: opacity, top;
+  -o-transition-duration: 1s;
+}
+.css_tt_hoverable:hover span {
+  font-family: Calibri, Tahoma, Geneva, sans-serif;
+  z-index: 99;
+  margin-left: 0;
+  opacity: 1;
+}
+.css_tt_hoverable.css_tt_top:hover span {
+  top: 2em;
+  margin-left: auto;
+}
+.css_tt_hoverable img {
+  position: absolute;
+  border: 0;
+  margin: -10px 0 0 -55px;
+  float: left;
+}
+.css_tt_hoverable em {
+  font: 700 1.2em Candara, Tahoma, Geneva, sans-serif;
+  display: block;
+  padding: 0.2em 0 0.6em 0;
+}
+.classic { padding: 0.8em 1em; }
+.custom { padding: 0.5em 0.8em 0.8em 2em; }
+* html a:hover { background: transparent; }
+.classic {background: #FFA; border: 1px solid #FFAD33; }
+.critical { background: #FCA; border: 1px solid #FF3334;  }
+.help { background: #9FDAEE; border: 1px solid #2BB0D7; }
+.info { background: #9FDAEE; border: 1px solid #2BB0D7; }
+.warning { background: #FFA; border: 1px solid #FFAD33; }

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/css_tt.rb

@@ -0,0 +1,47 @@
+# provides helper method available in views to generate css based tooltips
+module  CssTt
+  module CssTtHelper
+    # Returns a html markup which with help of css makes tooltips for given string
+    #
+    # Use helper in your views e.g.: 
+    #   <%= css_tt("I am text to be explained on hover", "I am the text in tooltip") %>
+    # This will generate a classic popup
+    #
+    # Some options are available for tooltips, like :type, :transition and :title
+    # * :type => possible options are :classic, :critical, :help, :warning, :info
+    # type defines the look of the tooltip and if other than classic adds an icon.
+    # types are quote self explainable
+    # * :transition => works only for webkit based browsers (i.e. Chrome, Safari), but
+    # is unobtrusive and does nothing on other browsers, because it's css based
+    # * :title => tootip title, optional
+    #
+    # You can use tooltips for whatever inline html element you want and add any 
+    # inline elements inside the tooltip.
+    #   <%= css_tt(link_to(smth, path), 
+    #           "<b>find</b> more #{link_to('here', path)}", 
+    #           :type => :info,
+    #           :title => "Outside link",
+    #           :transition => :left) %>
+    
+    def css_tt(smth_with_tooltip, tooltip_contents, opts = {})
+      defaults = {
+        :type => :classic,    # [:classic, :critical, :help, :warning, :info]
+        :transition => nil,   # [:left, :top]
+        :title => nil         #Information, Warning, Achtung, Atsargiai...
+      }
+      opts = defaults.merge opts
+      opts[:transition] = "css_tt_#{opts[:transition]}" if opts[:transition]
+      #css classes
+      hoverable_class = ('css_tt_hoverable ' + "#{opts[:transition]}").strip
+      tooltip_class = (opts[:type] && opts[:type] != :classic) ? "custom #{opts[:type]}" : 'classic'
+      
+      #tooltip itself
+      tooltip_contents = content_tag(:em, opts[:title])+tooltip_contents if opts[:title]
+      tooltip_contents = image_tag("/images/css_tt/#{opts[:type].to_s}.png", :alt => opts[:type].to_s, :width => "48", :height => "48")+tooltip_contents if opts[:type] && opts[:type] != :classic
+      tooltip = content_tag(:span, tooltip_contents, :class => tooltip_class)
+      
+      #result
+      return content_tag(:span, smth_with_tooltip + tooltip, :class => hoverable_class)
+    end
+  end
+end

data/rails/init.rb

@@ -0,0 +1 @@
+ActionView::Base.send  :include, CssTt::CssTtHelper

data/tasks/css_tt_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :css_tt do
+#   # Task goes here
+# end

data/test/css_tt_test.rb

@@ -0,0 +1,8 @@
+require 'test_helper'
+
+class CssTtTest < ActiveSupport::TestCase
+  # Replace this with your real tests.
+  test "the truth" do
+    assert true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'rubygems'
+require 'active_support'
+require 'active_support/test_case'

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: css_tt
+version: !ruby/object:Gem::Version 
+  hash: 25
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 3
+  version: 0.0.3
+platform: ruby
+authors: 
+- Tadas Tamosauskas
+- Alexander Dawson
+- Alex Hall
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-20 00:00:00 +03:00
+default_executable: 
+dependencies: []
+
+description: Dead simple pure CSS based tooltips for Rails
+email: tadastoo@yahoo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- css_tt.gemspec
+- install.rb
+- MIT-LICENSE
+- Rakefile
+- README.rdoc
+- uninstall.rb
+- generators/css_tt/css_tt_generator.rb
+- generators/css_tt/templates/critical.png
+- generators/css_tt/templates/css_tt.css
+- generators/css_tt/templates/help.png
+- generators/css_tt/templates/info.png
+- generators/css_tt/templates/warning.png
+- generators/css_tt/USAGE
+- lib/css_tt.rb
+- rails/init.rb
+- tasks/css_tt_tasks.rake
+- test/css_tt_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/medwezys/css_tt
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- CssTt
+- --main
+- README.rdoc
+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: 11
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 2
+summary: Dead simple pure CSS based tooltips for Rails.
+test_files: []
+