= BootstrapLeather

{<img src="https://badge.fury.io/rb/bootstrap_leather.svg" alt="Gem Version" />}[http://badge.fury.io/rb/bootstrap_leather]
{<img src="https://travis-ci.org/gemvein/bootstrap_leather.svg?branch=v0.2.3" alt="Build Status" />}[https://travis-ci.org/gemvein/bootstrap_leather]
{<img src="https://coveralls.io/repos/gemvein/bootstrap_leather/badge.png" alt="Coverage Status" />}[https://coveralls.io/r/gemvein/bootstrap_leather]


BootstrapLeather is a collection of view helpers that makes it easier to create apps using Twitter Bootstrap.

== Installation

Install the gem
    gem 'bootstrap_leather'
    bundle install

You will need to install bootstrap as a separate gem.  I recommend my own customizable_bootstrap gem, which makes use of boostrap-sass as a backend, but provides a set of files to make modifying it easier.

== Usage Examples

=== SEO tools for head and body alike: Title, Keywords, Description, Oh My!

In your view, assuming your model implements the given methods on the Item model (otherwise, omit):

    - add_title @item.title

    - add_keywords @item.keywords

    - add_description @item.description

    - add_head_css do
      = @item.css

    - add_footer_javascript do
      = @item.javascript

In your layout:
    %head
      = render_title          # For the title tag, including SEO content
      = render_keywords       # Defaults to what you put in the config file
      = render_description    # Can be hooked up within a mountable rails engine, too.
      = responsive_meta_tag   # If you're using the responsive features, you need this in your head

      <...>

      = render_head_css

    %body
      <...>

      .container
        = render_h1         # For the h1 tag containing the title alone

      <...>

      %footer
        = render_footer_javascript

=== Hero Units

To tell a view to add a hero unit, do:
    - add_hero_unit do
      %h1 This is a Hero Unit.
      %p This is its description paragraph, which isn't very clever but at least it's not lorem ipsum.

Then put one of these somewhere in your layout:
    = render_hero_unit

=== Alerts

To get all alerts, do:
    = alert_flash_messages

To create one alert, do:
    = alert 'alert-info', 'The message you want to alert with goes here.'

=== Widgets

To add a widget in any of your views:
    - add_widget do
      %h3 A widget is...
      %p  Not a bootstrap concept, but useful all the same.

To render the ones you have saved up:
    = render_widgets 'md', 3

=== Modals
    = modal 'Title of the modal here.' do
      %p Lorem ipsum, baby.

=== Badges and Labels
    = badge '25'
    = label 'unread'

=== Icons
    = icon 'check'

=== Navbars

:container_mode is optional and defaults to :none.  Can be one of: [:none, :with, :in]
For a wide navbar, try this:

    = navbar :container_mode => :with, :class => 'navbar-inverse' do
      = nav_list do
        = dropdown_nav_item 'Lorem', '#' do
          = nav_item 'Ipsum', '#'
          = nav_item 'Dolor', '#'
          = nav_item 'Sit', '#'
        = nav_item 'Ipsum', '#'
        = nav_item 'Dolor', '#'
        = nav_item 'Sit', '#'
      = nav_list :class => 'navbar-right' do
        = nav_item 'Amet', '#', :data => {:toggle => 'modal', :target => '#modal'}

=== Nav List
    = nav_list :class => 'nav-pills' do
        = nav_item 'Ipsum', '#'
        = nav_item 'Dolor', '#'
        = nav_item 'Sit', '#'

=== Tabs

First, add them all, then render them.
    - add_tab 'First Tab' do
      %p Tab contents go inside.
    - add_tab 'Second Tab' do
      %p Tab contents go inside here too.
    - add_tab 'Third Tab' do
      %p Yep, tab contents go inside.
    = render_tabs 'left'

=== Thumbnail

    = thumbnail link_to image_tag(image_url), path

== Great Bootstrap functionality outside the scope of this gem

The following are not covered because there are already so many wonderful resources providing this functionality.

* Bootstrap itself (I use my customizable_bootstrap, which is powered by bootstrap-sass, but you can use anything)
    * Consider the possibilities:
        * Any form of Bootstrap for Rails you want.
            * Less
            * Sass
        * A themed bootstrap replacement:
            * Kickstrap
            * Bootswatch
        * A theme generated on the fly:
            * Bootstrap ThemeRoller
            * Bootstrap Magic
* Jquery UI theme for bootstrap (I use jquery-ui-bootstrap-rails-asset)
* Forms (I recommend bootstrap_forms)
* Breadcrumb generation (try breadcrumbs_on_rails)
* Pagination (Try my bootstrap_pager)

== Contributing to BootstrapLeather
 
* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
* Fork the project.
* Start a feature/bugfix branch.
* Commit and push until you are happy with your contribution.
* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

== Copyright

Copyright (c) 2013-2014 Gem Vein. See LICENSE.txt for further details.