bootstrap-sass-extras 0.0.3 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a3fb89b0dac2bdbce1b2c0b80f970f8c2f8f4b4f
-  data.tar.gz: ff4cb7955a581564fa9f33b1e2a7d3cd20bff4a2
+SHA256:
+  metadata.gz: 83b3f7ce19029b2f212c749c14e38b51c11ca5478e3f8a8a04494c8644880aa9
+  data.tar.gz: 45dc961f7f3616e4e933fb4231855f1c689f2764049e5f7b6ca1ca518fb4cb46
 SHA512:
-  metadata.gz: 991f34f1c4b0c695d9aca47d7604fe04b33e5397b807d99940d1f89384c0fe9ba44945a8b30d8e48157ef9c0c409fa6054909fb95d52ea809be7d17cc27953bb
-  data.tar.gz: 10f5f1afbdbcb87cd455a0cceef1fc73adada250b1a6e2fca9d8e663a1889bc2c182cf3c44de3894c8e13c8591c7b8b098c4ae762da0f825d63676aa0d0c7867
+  metadata.gz: ab324f770c30db9789a28a3ee3f3956103ee456f030811f93233c5655fc856ffc5f9648fb1075bdb75461fc61dd0e0ecdaaa5902d9111fb352ad28276c8612a7
+  data.tar.gz: d9e551e802d1859661320e1ca9a2ef217c8ab64c92880110197421e8e7b999853ce4537acb632deaf596fca52a7347f9535ecc09a843310136584acb3a1b3b79

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+cache: bundler
+sudo: false
+rvm:
+  - 2.5.7
+  - 2.6.5
+before_install:
+  - gem update --system
+  - bundle update --bundler

data/CHANGELOG.md

@@ -1,14 +1,57 @@
 # Changelog
 
-## Relese 0.0.3
+## Release 0.1.0
 
-* Add glyph, model and breadcrumbs helpers
-* Update templates
+- Avoid dangerous calling of methods [@dlackty][]
+- Fix Travis CI [@dlackty][]
+- Add nav_to option to force active state [@sharshenov][]
+- use `before_action` over `before_filter` [@cantonic][]
+- Treat space-separated class names the same as arrays of class names in
+  button_to_with_bootstrap [@marcp][]
+- Freeze ALERT_TYPES_MAP to save allocations
+
+## Release 0.0.7
+
+- Added the ability to specify a custom view path for breadcrumbs [@fredwu][]
+- Put locale arg for String#pluralize in the view templates [@kayhide][]
+- Fix .haml themed template show.html.haml [@mskubenich][]
+- Augment button_to to generate the `btn` Bootstrap class. [@lowjoel][]
+- Given the nav helper, generate the appropriate Bootstrap tabs markup.
+  [@lowjoel][]
+- Allow pills and tabs to be used in the same manner. [@lowjoel][]
+
+## Release 0.0.6
+
+- Update to bootstrap 3.0
+- Add a `badge(badge_count)` helper by [@pdobb][]
+- Clean up codes by [@pdobb][]
+
+## Release 0.0.5
+
+- Adjust bootstrap_flash to match bootstrap alerts by [@jonwaghorn][]
+- Rails Form Helper for Bootstrap META tag by [@dabit][]
+
+## Release 0.0.4
+
+- Fix BreadCrumbs Helper
+
+## Release 0.0.3
+
+- Add glyph, model and breadcrumbs helpers
+- Update templates
 
 ## Release 0.0.2
 
-* Add layout and views generators
+- Add layout and views generators
 
 ## Release 0.0.1
 
-* Initial version
+- Initial version
+
+[@lowjoel]: https://github.com/lowjoel
+[@mskubenich]: https://github.com/mskubenich
+[@kayhide]: https://github.com/kayhide
+[@fredwu]: https://github.com/fredwu
+[@jonwaghorn]: https://github.com/jonwaghorn
+[@pdobb]: https://github.com/pdobb
+[@dabit]: https://github.com/dabit

data/Gemfile

@@ -3,4 +3,7 @@ source "http://rubygems.org"
 # Declare your gem's dependencies in bootstrap-sass-extras.gemspec.
 # Bundler will treat runtime dependencies like base dependencies, and
 # development dependencies will be added by default to the :development group.
-gemspec
+gemspec
+
+# gem 'byebug'
+gem 'pry'

data/Gemfile.lock

@@ -1,107 +1,167 @@
 PATH
   remote: .
   specs:
-    bootstrap-sass-extras (0.0.1)
+    bootstrap-sass-extras (0.1.0)
       rails (>= 3.1.0)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    actionmailer (3.2.13)
-      actionpack (= 3.2.13)
-      mail (~> 2.5.3)
-    actionpack (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
-      builder (~> 3.0.0)
-      erubis (~> 2.7.0)
-      journey (~> 1.0.4)
-      rack (~> 1.4.5)
-      rack-cache (~> 1.2)
-      rack-test (~> 0.6.1)
-      sprockets (~> 2.2.1)
-    activemodel (3.2.13)
-      activesupport (= 3.2.13)
-      builder (~> 3.0.0)
-    activerecord (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
-      arel (~> 3.0.2)
-      tzinfo (~> 0.3.29)
-    activeresource (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
-    activesupport (3.2.13)
-      i18n (= 0.6.1)
-      multi_json (~> 1.0)
-    arel (3.0.2)
-    builder (3.0.4)
-    diff-lcs (1.1.3)
-    erubis (2.7.0)
-    hike (1.2.1)
-    i18n (0.6.1)
-    journey (1.0.4)
-    json (1.7.7)
-    mail (2.5.3)
-      i18n (>= 0.4.0)
-      mime-types (~> 1.16)
-      treetop (~> 1.4.8)
-    mime-types (1.21)
-    multi_json (1.7.2)
-    polyglot (0.3.3)
-    rack (1.4.5)
-    rack-cache (1.2)
-      rack (>= 0.4)
-    rack-ssl (1.3.3)
-      rack
-    rack-test (0.6.2)
-      rack (>= 1.0)
-    rails (3.2.13)
-      actionmailer (= 3.2.13)
-      actionpack (= 3.2.13)
-      activerecord (= 3.2.13)
-      activeresource (= 3.2.13)
-      activesupport (= 3.2.13)
-      bundler (~> 1.0)
-      railties (= 3.2.13)
-    railties (3.2.13)
-      actionpack (= 3.2.13)
-      activesupport (= 3.2.13)
-      rack-ssl (~> 1.3.2)
+    actioncable (6.0.3.1)
+      actionpack (= 6.0.3.1)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+    actionmailbox (6.0.3.1)
+      actionpack (= 6.0.3.1)
+      activejob (= 6.0.3.1)
+      activerecord (= 6.0.3.1)
+      activestorage (= 6.0.3.1)
+      activesupport (= 6.0.3.1)
+      mail (>= 2.7.1)
+    actionmailer (6.0.3.1)
+      actionpack (= 6.0.3.1)
+      actionview (= 6.0.3.1)
+      activejob (= 6.0.3.1)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 2.0)
+    actionpack (6.0.3.1)
+      actionview (= 6.0.3.1)
+      activesupport (= 6.0.3.1)
+      rack (~> 2.0, >= 2.0.8)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.2.0)
+    actiontext (6.0.3.1)
+      actionpack (= 6.0.3.1)
+      activerecord (= 6.0.3.1)
+      activestorage (= 6.0.3.1)
+      activesupport (= 6.0.3.1)
+      nokogiri (>= 1.8.5)
+    actionview (6.0.3.1)
+      activesupport (= 6.0.3.1)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.1, >= 1.2.0)
+    activejob (6.0.3.1)
+      activesupport (= 6.0.3.1)
+      globalid (>= 0.3.6)
+    activemodel (6.0.3.1)
+      activesupport (= 6.0.3.1)
+    activerecord (6.0.3.1)
+      activemodel (= 6.0.3.1)
+      activesupport (= 6.0.3.1)
+    activestorage (6.0.3.1)
+      actionpack (= 6.0.3.1)
+      activejob (= 6.0.3.1)
+      activerecord (= 6.0.3.1)
+      marcel (~> 0.3.1)
+    activesupport (6.0.3.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+      zeitwerk (~> 2.2, >= 2.2.2)
+    builder (3.2.4)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.6)
+    crass (1.0.6)
+    diff-lcs (1.3)
+    erubi (1.9.0)
+    globalid (0.4.2)
+      activesupport (>= 4.2.0)
+    i18n (1.8.2)
+      concurrent-ruby (~> 1.0)
+    loofah (2.5.0)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    mail (2.7.1)
+      mini_mime (>= 0.1.1)
+    marcel (0.3.3)
+      mimemagic (~> 0.3.2)
+    method_source (0.9.2)
+    mimemagic (0.3.5)
+    mini_mime (1.0.2)
+    mini_portile2 (2.4.0)
+    minitest (5.14.1)
+    nio4r (2.5.4)
+    nokogiri (1.10.9)
+      mini_portile2 (~> 2.4.0)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rack (2.2.2)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails (6.0.3.1)
+      actioncable (= 6.0.3.1)
+      actionmailbox (= 6.0.3.1)
+      actionmailer (= 6.0.3.1)
+      actionpack (= 6.0.3.1)
+      actiontext (= 6.0.3.1)
+      actionview (= 6.0.3.1)
+      activejob (= 6.0.3.1)
+      activemodel (= 6.0.3.1)
+      activerecord (= 6.0.3.1)
+      activestorage (= 6.0.3.1)
+      activesupport (= 6.0.3.1)
+      bundler (>= 1.3.0)
+      railties (= 6.0.3.1)
+      sprockets-rails (>= 2.0.0)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.3.0)
+      loofah (~> 2.3)
+    railties (6.0.3.1)
+      actionpack (= 6.0.3.1)
+      activesupport (= 6.0.3.1)
+      method_source
       rake (>= 0.8.7)
-      rdoc (~> 3.4)
-      thor (>= 0.14.6, < 2.0)
-    rake (10.0.3)
-    rdoc (3.12.2)
-      json (~> 1.4)
-    rspec-core (2.12.2)
-    rspec-expectations (2.12.1)
-      diff-lcs (~> 1.1.3)
-    rspec-mocks (2.12.1)
-    rspec-rails (2.12.1)
+      thor (>= 0.20.3, < 2.0)
+    rake (13.0.1)
+    rspec-core (3.8.2)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-rails (3.8.2)
       actionpack (>= 3.0)
       activesupport (>= 3.0)
       railties (>= 3.0)
-      rspec-core (~> 2.12.0)
-      rspec-expectations (~> 2.12.0)
-      rspec-mocks (~> 2.12.0)
-    sprockets (2.2.2)
-      hike (~> 1.2)
-      multi_json (~> 1.0)
-      rack (~> 1.0)
-      tilt (~> 1.1, != 1.3.0)
-    sqlite3 (1.3.7)
-    thor (0.17.0)
-    tilt (1.3.6)
-    treetop (1.4.12)
-      polyglot
-      polyglot (>= 0.3.1)
-    tzinfo (0.3.37)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.2)
+    sprockets (4.0.2)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.2.2)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    sqlite3 (1.4.1)
+    thor (1.0.1)
+    thread_safe (0.3.6)
+    tzinfo (1.2.7)
+      thread_safe (~> 0.1)
+    websocket-driver (0.7.3)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.5)
+    zeitwerk (2.3.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   bootstrap-sass-extras!
+  pry
   rspec-rails
   sqlite3
+
+BUNDLED WITH
+   1.17.2

data/README.md

@@ -5,6 +5,12 @@
   [1]: https://github.com/thomas-mcdonald/bootstrap-sass
   [2]: https://github.com/seyhunak/twitter-bootstrap-rails
 
+  [![Build Status](https://travis-ci.org/doabit/bootstrap-sass-extras.png?branch=master)](https://travis-ci.org/doabit/bootstrap-sass-extras)
+
+## Note
+
+From version 0.0.6, only support bootstrap 3. If you want to use bootstrap 2, please use version 0.0.5.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -28,65 +34,86 @@ Generate locale
 
 Usage:
 
-
-    rails g bootstrap:install
-
+```ruby
+rails g bootstrap:install
+```
 
 Layout (generates Twitter Bootstrap compatible layout) - (Haml and Slim supported)
 
 
 Usage:
 
-
-    rails g bootstrap:layout [LAYOUT_NAME] [*fixed or fluid]
-
+```ruby
+rails g bootstrap:layout [LAYOUT_NAME] [*fixed or fluid]
+```
 
 Example of a fixed layout:
 
-
-    rails g bootstrap:layout application fixed
-
+```ruby
+rails g bootstrap:layout application fixed
+```
 
 Example of a responsive layout:
 
-
-    rails g bootstrap:layout application fluid
-
+```ruby
+rails g bootstrap:layout application fluid
+```
 
 Themed (generates Twitter Bootstrap compatible scaffold views.) - (Haml and Slim supported)
 
 
 Usage:
 
-
-    rails g bootstrap:themed [RESOURCE_NAME]
-
+```ruby
+rails g bootstrap:themed [RESOURCE_NAME]
+```
 
 Example:
 
-
-    rails g scaffold Post title:string description:text
-    rake db:migrate
-    rails g bootstrap:themed Posts
+```ruby
+rails g scaffold Post title:string description:text
+rake db:migrate
+rails g bootstrap:themed Posts
+```
 
 Notice the plural usage of the resource to generate bootstrap:themed.
 
 ## Using Helpers
 
+### Viewport Meta Helper
+Add the viewport meta helper `<%= viewport_meta_tag %>` to your layout
+(built-in with layout generator) to render the required meta tag for Bootstrap:
+
+```html
+<meta content="width=device-width,initial-scale=1.0" name="viewport" />
+```
+
+You can change the content value by passing a hash as an argument:
+
+```erb
+<%= viewport_meta_tag(:maximum_scale => "1.0") %>
+```
+
+Renders:
+
+```html
+<meta content="width=device-width,initial-scale=1.0,maximum-scale=1.0" name="viewport" />
+```
+
 ### Flash helper
 Add flash helper `<%= bootstrap_flash %>` to your layout (built-in with layout generator)
 
 ### Modal Helper
 You can create modals easily using the following example. The header, body, and footer all accept content_tag or plain html.
-The href of the button to launch the modal must matche the id of the modal dialog.
-
-```ruby
-<%= content_tag :a, "Modal", :href => "#modal", :class => 'btn', :data => {:toggle => modal'} %>
+The href of the button to launch the modal must match the id of the modal dialog.
 
+```erb
+<%= modal_toggle 'Modal', dialog: '#modal'%>
 <%= modal_dialog :id => "modal",
-         :header => { :show_close => true, :dismiss => 'modal', :title => 'Modal header' },
-                 :body   => 'This is the body',
-                 :footer => content_tag(:button, 'Save', :class => 'btn') %>
+         :header => { :show_close => true, :title => 'Modal header' },
+         :body   => 'This is the body',
+         :footer => content_tag(:button, 'Save', :class => 'btn btn-primary')
+%>
 ```
 
 ### Breadcrumbs Helpers
@@ -94,8 +121,6 @@ The href of the button to launch the modal must matche the id of the modal dialo
 *Notice* If your application is using [breadcrumbs-on-rails](https://github.com/weppos/breadcrumbs_on_rails) you will have a namespace collision with the add_breadcrumb method.
 You do not need to use these breadcrumb gems since this gem provides the same functionality out of the box without the additional dependency.
 
-Add breadcrumbs helper `<%= render_breadcrumbs %>` to your layout.
-
 ```ruby
 class ApplicationController
   add_breadcrumb :index, :root_path
@@ -112,18 +137,101 @@ class ExamplesController < ApplicationController
   def show
     @example = Example.find params[:id]
     add_breadcrumb @example.name, example_path(@example)
-    # add_breadcrumb :show, example_path(@example)
+    add_breadcrumb :show, example_path(@example)
   end
 end
 ```
 
-### Glyp Helper
+Finally, add the `<%= render_breadcrumbs %>` helper to your layout.
+
+You can wrap the breadcrumbs in an HTML element by using the block form like this:
+
+```erb
+<%= render_breadcrumbs do |breadcrumbs| %>
+  <%= content_tag(:div, breadcrumbs, class: "container") %>
+<% end %>
+
+# =>
+# <div class="container">
+#   <ol class="breadcrumb">
+#     <li> ... </li>
+#     <li class="active"> ... </li>
+#   </ol>
+# </div>
+```
+
+You can also optionally specify which custom view partial you would like to use for rendering the breadcrumbs:
+
+```erb
+<%= render_breadcrumbs partial: 'path/to/custom/breadcrumbs' %>
+```
+
+There are also a few interface methods available for working with the internal breadcrumbs hashes. The following methods are available in controllers and views.
 
 ```ruby
-glyph(:share_alt)
-# => <i class="icon-share-alt"></i>
-glyph(:lock, :white)
-# => <i class="icon-lock icon-white"></i>
+# Given previously added breadcrumbs:
+
+breadcrumbs?
+# => true
+
+breadcrumb_names
+# => ["example", "show"]
+```
+
+The following method is available to controllers only.
+
+```ruby
+clear_breadcrumbs
+# => nil
+```
+
+### Nav Helper
+
+To render the Bootstrap example:
+
+```html
+<ul class="nav nav-tabs">
+  <li role="presentation" class="active"><a href="/">Home</a></li>
+  <li role="presentation"><a href="/profile">Profile</a></li>
+  <li role="presentation"><a href="/messages">Messages</a></li>
+</ul>
+```
+
+In your views:
+
+```erb
+<%= nav do %>
+  <%= nav_to('Home', root_path) %>
+  <%= nav_to(profile_path) do %>
+    Profile
+  <% end %>
+  <%= nav_to('Messages', controller: users, action: :messages) %>
+  <%= nav_to('Forced active state', some_path, active: true) %>
+<% end %>
+```
+
+The `tabs` helper declares that a tab component is being used. Alternatively, the `pills` helper can
+be used in the same manner. Other classes can be specified in the `class` hash argument, the `nav`
+class need not be specified.
+
+The `nav_to` helper accepts the same methods that the `link_to` helper accepts, but also 
+automatically applies the `active` class to the active link.
+
+### Glyph Helper
+
+```erb
+<%= glyph(:star) %>
+# => <span class="glyphicon glyphicon-star"></span>
+
+<%= glyph(:star, :paperclip) %>
+# => <span class="glyphicon glyphicon-star"></span><span class="glyphicon glyphicon-paperclip"></span>
+```
+
+### Badge Helper
+
+```erb
+<%= badge(2) %>
+# => <span class="badge">2</span>
 ```
 
 ## Contributing