bootstrap-helpers 0.1.1

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+gem 'rails'
+
+group :development do  
+  gem "bundler"
+  gem "jeweler", "~> 1.8.4"
+end

data/Gemfile.lock

@@ -0,0 +1,93 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.2.8)
+      actionpack (= 3.2.8)
+      mail (~> 2.4.4)
+    actionpack (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.1.3)
+    activemodel (3.2.8)
+      activesupport (= 3.2.8)
+      builder (~> 3.0.0)
+    activerecord (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+    activesupport (3.2.8)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    arel (3.0.2)
+    builder (3.0.0)
+    erubis (2.7.0)
+    git (1.2.5)
+    hike (1.2.1)
+    i18n (0.6.0)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    journey (1.0.4)
+    json (1.7.4)
+    mail (2.4.4)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.19)
+    multi_json (1.3.6)
+    polyglot (0.3.3)
+    rack (1.4.1)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rails (3.2.8)
+      actionmailer (= 3.2.8)
+      actionpack (= 3.2.8)
+      activerecord (= 3.2.8)
+      activeresource (= 3.2.8)
+      activesupport (= 3.2.8)
+      bundler (~> 1.0)
+      railties (= 3.2.8)
+    railties (3.2.8)
+      actionpack (= 3.2.8)
+      activesupport (= 3.2.8)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    sprockets (2.1.3)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    thor (0.15.4)
+    tilt (1.3.3)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.33)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  jeweler (~> 1.8.4)
+  rails

data/README.md

@@ -0,0 +1,152 @@
+# bootstrap-helpers
+## Rails bootstrap helpers
+
+### Install
+
+``` rb
+  gem "bootstrap-helpers"
+```
+
+## List of helpers
+
+### Scaffold
+
+ * `container(opts = {}, &block)`
+ * `row(opts = {}, &block)`
+ * `span(size, opts = {}, &block)`
+ * `icon(icon_id)`
+
+*eg*
+
+``` erb
+<%= container :id => "main" do %>
+  <%= row :class => "myRow" do %>
+    <%= span 5, :offset => 2 do %>
+      <p>Span content</p>
+    <% end %>
+  <% end %>
+<% end %> 
+```
+
+Passing `:fluid => true` to `container` will set the layout to fluid and thus rows will be builded accordingly as `row-fluid`.
+
+### Base CSS
+
+ * `button(*args, &block)`
+ * `form_actions(&block)`
+
+*eg*
+
+``` erb
+	  <%= button "New Post", new_post_path, :type => :primary %>
+```
+
+### Navigation  
+ 
+ * `navbar(*args, &block)`
+ * `nav(options = {}, &block)`
+ * `pills(options = {}, &block)`
+ * `nav_header(title)`
+ * `nav_list(options = {}, &block)`
+ * `dropdown_nav_item(label, opts = {}, &block)`
+ * `nav_item(*args, &block)`
+ * `brand(*args, &block)`
+
+``` erb
+<%= navbar :fixed => :top do %>
+  <%= brand app_name, "/" %>
+<% end %>
+```
+
+``` erb
+<%= nav do %>
+  <%= nav_item "Homepage", "/", :icon => "home" , :icon_color => :white %>
+  <%= dropdown_nav_item "Account", :icon => "user" , :icon_color => :white do %>
+      <%= nav_item 'Logout', destroy_user_session_path, :method => :delete %>
+  <% end %>
+<% end %>
+```
+
+``` erb
+<%= nav_list do %>
+  <%= nav_header "Website" %>    
+  <%= nav_item "Pages", admin_pages_path %>
+  <%= nav_item "Menus", admin_menus_path %>
+
+  <%= nav_header "Contents" %>    
+  <%= nav_item "Photogalleries", admin_photogalleries_path %>
+  <%= nav_item "Posts", admin_posts_path %>
+
+  <%= nav_header "Users" %>
+  <%= nav_item "Users", admin_users_path %>    
+<% end %>
+```
+
+### Components
+
+* `tabs(opts = {})`
+* `accordion(opts = {})`
+* `alert(message)`
+
+
+``` erb
+<%= accordion do |a| %>
+
+  <%= a.pane "Pane1" do %>
+    Content 1
+  <% end %>
+
+  <%= a.pane "Pane2" do %>
+    Content 2
+  <% end %>
+
+  <%= a.pane "Pane3" do %>
+    Content 3
+  <% end %>
+
+<% end %>
+```
+
+
+``` erb
+<%= tabs do |t| %>
+
+  <%= t.pane "Pane1" do %>
+    Content 1
+  <% end %>
+
+  <%= t.pane "Pane2" do %>
+    Content 2
+  <% end %>
+
+  <%= t.pane "Pane3" do %>
+    Content 3
+  <% end %>
+
+<% end %>
+```
+
+---
+
+Copyright (c) 2012 mcasimir
+
+MIT License
+
+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,53 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "bootstrap-helpers"
+  gem.homepage = "http://github.com/mcasimir/kaminari-bootstrap"
+  gem.license = "MIT"
+  gem.summary = %Q{Rails bootstrap helpers}
+  gem.description = %Q{Rails bootstrap helpers}
+  gem.email = "maurizio.cas@gmail.com"
+  gem.authors = ["mcasimir"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+
+task :push do
+  message = ENV["message"] || "commit #{Time.now}"
+  `git add . && git commit -a -m '#{message}' && git push`
+end
+
+task "release:patch" do
+  Rake::Task["gemspec"].invoke
+  Rake::Task["version:bump:patch"]
+  Rake::Task["push"].invoke
+  Rake::Task["release"].invoke  
+end
+
+task "release:minor" do
+  Rake::Task["gemspec"].invoke
+  Rake::Task["version:bump:minor"]
+  Rake::Task["push"].invoke
+  Rake::Task["release"].invoke  
+end
+
+task "release:major" do
+  Rake::Task["gemspec"].invoke
+  Rake::Task["version:bump:major"]
+  Rake::Task["push"].invoke
+  Rake::Task["release"].invoke  
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/bootstrap-helpers.gemspec

@@ -0,0 +1,51 @@
+# 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 = "bootstrap-helpers"
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["mcasimir"]
+  s.date = "2012-08-11"
+  s.description = "Rails bootstrap helpers"
+  s.email = "maurizio.cas@gmail.com"
+  s.extra_rdoc_files = [
+    "README.md"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "bootstrap-helpers.gemspec",
+    "lib/bootstrap-helpers.rb"
+  ]
+  s.homepage = "http://github.com/mcasimir/kaminari-bootstrap"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Rails bootstrap helpers"
+
+  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<rails>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+    else
+      s.add_dependency(%q<rails>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    end
+  else
+    s.add_dependency(%q<rails>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+  end
+end
+

data/lib/bootstrap-helpers.rb

@@ -0,0 +1,331 @@
+# Author::    Maurizio Casimirri (mailto:maurizio.cas@gmail.com)
+# Copyright:: Copyright (c) 2012 Maurizio Casimirri
+# 
+# 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.
+
+module BootstrapHelpers
+
+  # ============
+  # = Scaffold =
+  # ============
+
+  def bootstrap_container_class
+    bootstrap_fluid? ? "container-fluid" : "container"
+  end
+    
+  def bootstrap_row_class
+    bootstrap_fluid? ? "row-fluid" : "row"
+  end
+
+  def bootstrap_fluid!
+    @bootstrap_float_style = true
+  end
+
+  def bootstrap_fluid?
+    !!@bootstrap_float_style
+  end
+    
+  def container(opts = {}, &block)
+    if opts.delete(:fluid)
+      bootstrap_fluid!
+    end
+      
+    opts[:class] = ("#{opts[:class]}".split(" ") + [bootstrap_container_class]).join(" ")   
+    content_tag("div", opts, &block)
+  end
+
+  def row(opts = {}, &block)
+
+    opts[:class] = ("#{opts[:class]}".split(" ") + [bootstrap_row_class]).join(" ")
+    content_tag("div", opts, &block)      
+  end
+        
+  def span(size, opts = {}, &block)
+    offset = opts.delete(:offset)
+    class_arr =  ("#{opts[:class]}".split(" ") + ["span#{size}"])
+    if offset
+      class_arr << "offset#{offset}"
+    end
+      
+    opts[:class] = class_arr.join(" ")
+    content_tag("div", opts, &block)
+      
+  end
+    
+  def icon(icon_id)
+    "<i class=\"icon icon-#{icon_id}\"></i>".html_safe
+  end
+  
+  # ============
+  # = Base CSS =
+  # ============
+  
+  
+  def button(*args, &block)
+    if !block_given?
+      opts = args.extract_options!
+      is_link = (!!args.second) || (args.any? && block_given?)
+
+      icon = opts.delete(:icon)
+      type_opt =  opts.delete(:type)
+      kind = type_opt ? "btn-#{type_opt}" : nil
+      size_opt = opts.delete(:size)
+      size = size_opt ? "btn-#{size_opt}" : nil
+      klasses = ("#{opts[:class]}".split(/\s+/) + ["btn", kind, size]).compact.uniq
+      opts[:class] = klasses.join(" ")
+      if icon
+        icon_color = opts.delete(:icon_color)
+        classes = [icon, icon_color].compact.map {|c| "icon-#{c}"}.join(" ")
+        args.unshift "<i class=\"#{classes}\"></i> #{args.shift}".html_safe
+      end
+
+      args << opts
+    end
+
+    if is_link
+      link_to(*args, &block)
+    else
+      content_tag('button', *args, &block)
+    end
+
+  end
+
+  alias :btn :button
+  
+  
+  def form_actions(&block)
+    content_tag :div, :class => "form-actions", &block
+  end
+
+  def alert(message)
+    "<div class='alert'>#{h(message)}</div>".html_safe
+  end
+  
+  
+  # ==============
+  # = Navigation =
+  # ==============
+    
+  def navbar(*args, &block)
+    opts = args.extract_options!
+    html = <<-STR
+    <div class="navbar#{opts[:fixed].present? ? ' navbar-fixed-' + opts[:fixed].to_s : ''}">
+      <div class="navbar-inner">
+        <div class="#{bootstrap_container_class}">
+          #{capture(&block)}
+        </div>
+      </div>
+    </div>
+    STR
+
+    html.html_safe
+  end
+
+
+  def nav(options = {}, &block)
+    "<ul class=\"nav #{options[:class]}\">#{capture(&block)}</ul>".html_safe
+  end
+      
+  def pills(options = {}, &block)
+    "<ul class=\"nav nav-pills #{options[:class]}\">#{capture(&block)}</ul>".html_safe
+  end
+    
+  def nav_header(txt)
+    "<li class=\"nav-header\">#{txt}</li>".html_safe
+  end
+
+  def nav_list(options = {}, &block)
+    "<ul class=\"nav nav-list #{options[:class]}\">#{capture(&block)}</ul>".html_safe
+  end
+
+  def dropdown_nav_item(label, opts = {}, &block)
+    icon = opts.delete(:icon)
+    if icon
+      icon_color = opts.delete(:icon_color)
+      classes = [icon, icon_color].compact.map {|c| "icon-#{c}"}.join(" ")
+      label =  "<i class=\"#{classes}\"></i> #{label}".html_safe
+    end
+
+    html = <<-STR
+      <li class="dropdown">
+      <a class="dropdown-toggle"
+       data-toggle="dropdown"
+       href="#">
+        #{label}
+        <b class="caret"></b>
+      </a>
+      <ul class="dropdown-menu">#{capture(&block)}</ul></li>
+    STR
+    html.html_safe
+  end
+
+
+  def nav_item(*args, &block)
+    if !block_given?
+      opts = args.extract_options!
+      icon = opts.delete(:icon)
+      float = opts.delete(:float)
+      if icon
+        icon_color = opts.delete(:icon_color)
+        classes = [icon, icon_color].compact.map {|c| "icon-#{c}"}.join(" ")
+        args.unshift "<i class=\"#{classes}\"></i> #{h(args.shift)}".html_safe
+      end
+      args << opts
+    end
+
+    url = block_given? ? args.first : args[1]
+
+    classes = []
+    if current_page?(url)
+      classes <<  "active"
+    end
+
+    if  float
+      classes += ["float", "#{float}"]
+    end
+
+    with_class = classes.any? ? " class='#{classes.join(' ')}'" : ""
+    "<li#{with_class}>#{link_to(*args, &block)}</li>".html_safe
+  end
+
+
+  def brand(*args, &block)
+
+    if !args.last.is_a?(Hash)
+      args << {}
+    end
+    args.last[:class] = "brand"
+
+    link_to(*args, &block)
+  end
+
+    
+  # ========
+  # = Tabs =
+  # ========
+    
+  class TabsBuilder
+
+    attr_reader :parent, :pane_contents, :pane_handles
+    delegate :capture, :content_tag, :to => :parent
+
+    def initialize parent
+      @first = true
+      @parent = parent
+      @pane_handles = []
+      @pane_contents = []
+    end
+
+    def pane title, &block
+      css_class, @first = 'active', false if @first
+      link = content_tag(:a, title, :'data-toggle' => 'tab', :href => "##{title.parameterize}_tab")
+      @pane_handles << content_tag(:li, link, :class => css_class)
+      @pane_contents << (content_tag :div, :class => "tab-pane #{css_class}", :id => "#{title.parameterize}_tab" do
+        capture(&block)
+      end)
+      nil
+    end
+      
+  end  # ~ TabsBuilder
+
+
+  def tabs(opts = {})
+    opts[:direction] ||= 'above'
+    opts[:style] ||= 'tabs'
+    builder = TabsBuilder.new self
+    yield builder
+    tabs = content_tag(:ul, builder.pane_handles.join("\n").html_safe, :class => "nav nav-#{opts[:style]}")
+    contents = content_tag(:div, builder.pane_contents.join("\n").html_safe, :class => 'tab-content')
+    css_direction = "tabs-#{opts[:direction]}" unless opts[:direction] == 'above'
+    content_tag :div, :class => "tabbable #{css_direction}" do
+      if opts[:direction] == 'below'
+        contents + tabs
+      else
+        tabs + contents
+      end
+    end
+  end
+
+
+  # =============
+  # = Accordion =
+  # =============
+    
+  class AccordionBuilder
+
+    attr_reader :parent
+    delegate :capture, :content_tag, :link_to, :to => :parent
+
+    def initialize(opts, parent)
+      @first = true
+      @parent = parent
+      @opts = opts
+    end
+
+    def pane(title, &block)
+      css_class =  (@first && @opts[:open]) ? 'in' : ''
+      @first = false
+      content_tag :div, :class => 'accordion-group' do
+        heading = content_tag :div, :class => 'accordion-heading' do
+          link_to title, "##{title.parameterize}_pane", :class => 'accordion-toggle', :'data-toggle' => 'collapse',
+          :'data-parent' => "##{@opts[:accordion_id]}"
+        end
+        body = content_tag :div, :class => "accordion-body collapse #{css_class}", :id => "#{title.parameterize}_pane" do
+          content_tag :div, :class => 'accordion-inner' do
+            capture(&block)
+          end
+        end
+        heading + body
+      end
+    end
+  
+  end # ~ AccordionBuilder
+  
+  def accordion(opts = {})
+    opts[:accordion_id] ||= 'accordion'
+    builder = AccordionBuilder.new opts, self
+    content_tag :div, :class => 'accordion', :id => opts[:accordion_id] do
+      yield builder
+    end
+  end
+    
+end
+
+ActionView::Base.send :include, BootstrapHelpers 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+    
+
+

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: bootstrap-helpers
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease: 
+platform: ruby
+authors:
+- mcasimir
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+description: Rails bootstrap helpers
+email: maurizio.cas@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- VERSION
+- bootstrap-helpers.gemspec
+- lib/bootstrap-helpers.rb
+homepage: http://github.com/mcasimir/kaminari-bootstrap
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -4429154263409720929
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Rails bootstrap helpers
+test_files: []