<commit_before>=============================
bootstrap-progressbar - 0.4.0
=============================

``bootstrap-progressbar`` is a jQuery_ plugin which extends the basic twitter-bootstrap_ progressbar. It provides the ability to animate the progressbar by adding Javascript in combination with the preexisting css transitions. Additionally you can display the current percent value inside the bar.

.. _jQuery: http://jquery.com/
.. _twitter-bootstrap: http://twitter.github.com/bootstrap/

Useage
======

1. include ``bootstrap-progressbar.js``::

    <script type="text/javascript" src="bootstrap-progressbar.js"></script>

#. activate ``bootstrap-progressbar`` functionality on progressbars of your choice::

    $(document).ready(function() {
        $('.progress .bar').progressbar();
    });

#. set the ``data`` attribute and **remove** the ``width`` style attribute (alternatively you can set it to 0)

    1. ``data-percentage``::

        <div class="progress progress-info">
            <div class="bar" data-percentage="75"></div>
        </div>

    #. ``data-amount-part`` and ``data-amount-total``::

         <div class="progress progress-info">
             <div class="bar" data-amount-part="1337" data-amount-total="9000"></div>
         </div>

Customization
=============

1. text and delay

    simply add additional parameters when activating the script::

        $(document).ready(function() {
            $('.progress .bar').progressbar({
                transition_delay: 300
            ,   refresh_speed: 50
            ,   display_text: 2
            ,   use_percentage: true
            ,   border_radius: '4px'
            ,   callback: doSomethingCool( current_percentage ) { .. }
            });
        });

    * ``transition_delay`` is the time in milliseconds until the animation starts
    * ``refresh_speed`` is the time in milliseconds which will elapse between every text refresh / callback call
    * ``display_text`` determines whether the text will be displayed

        * ``0`` no text
        * ``1`` text on filled bar
        * ``2`` text on center
    * ``use_percentage`` determines whether the text will be displayed in percent or amount
    * ``border_radius`` hook to change the border radius of the progressbar (only in center text mode - default: 4px)
    * ``callback`` hook where you can grab the actual percentage value

#. to change the animation itself you have to overwrite either less or css

    * less::

        .progress .bar {
          .transition(width 2s ease-in-out);
        }

    * css::

        .progress .bar {
            -webkit-transition: width 2s ease-in-out;
            -moz-transition: width 2s ease-in-out;
            -ms-transition: width 2s ease-in-out;
            -o-transition: width 2s ease-in-out;
            transition: width 2s ease-in-out;
        }

Demo
====

* http://www.minddust.com/bootstrap-progressbar-demo/

License
=======

Copyright 2012 minddust.com_

.. _minddust.com: http://www.minddust.com/

bootstrap-progressbar is published under Apache License, Version 2.0 (see LICENSE file).<commit_msg>updated description<commit_after>=============================
bootstrap-progressbar - 0.4.0
=============================

``bootstrap-progressbar`` is a jQuery_ plugin which extends the basic twitter-bootstrap_ progressbar. It provides the ability to animate the progressbar by adding Javascript in combination with the preexisting css transitions. Additionally you can display the current progress information in the bar or via callback.

.. _jQuery: http://jquery.com/
.. _twitter-bootstrap: http://twitter.github.com/bootstrap/

Useage
======

1. include ``bootstrap-progressbar.js``::

    <script type="text/javascript" src="bootstrap-progressbar.js"></script>

#. activate ``bootstrap-progressbar`` functionality on progressbars of your choice::

    $(document).ready(function() {
        $('.progress .bar').progressbar();
    });

#. set the ``data`` attribute and **remove** the ``width`` style attribute (alternatively you can set it to 0)

    1. ``data-percentage``::

        <div class="progress progress-info">
            <div class="bar" data-percentage="75"></div>
        </div>

    #. ``data-amount-part`` and ``data-amount-total``::

         <div class="progress progress-info">
             <div class="bar" data-amount-part="1337" data-amount-total="9000"></div>
         </div>

Customization
=============

1. text and delay

    simply add additional parameters when activating the script::

        $(document).ready(function() {
            $('.progress .bar').progressbar({
                transition_delay: 300
            ,   refresh_speed: 50
            ,   display_text: 2
            ,   use_percentage: true
            ,   border_radius: '4px'
            ,   callback: doSomethingCool( current_percentage ) { .. }
            });
        });

    * ``transition_delay`` is the time in milliseconds until the animation starts
    * ``refresh_speed`` is the time in milliseconds which will elapse between every text refresh / callback call
    * ``display_text`` determines whether the text will be displayed

        * ``0`` no text
        * ``1`` text on filled bar
        * ``2`` text on center
    * ``use_percentage`` determines whether the text will be displayed in percent or amount
    * ``border_radius`` hook to change the border radius of the progressbar (only in center text mode - default: 4px)
    * ``callback`` hook where you can grab the actual percentage value

#. to change the animation itself you have to overwrite either less or css

    * less::

        .progress .bar {
          .transition(width 2s ease-in-out);
        }

    * css::

        .progress .bar {
            -webkit-transition: width 2s ease-in-out;
            -moz-transition: width 2s ease-in-out;
            -ms-transition: width 2s ease-in-out;
            -o-transition: width 2s ease-in-out;
            transition: width 2s ease-in-out;
        }

Demo
====

* http://www.minddust.com/bootstrap-progressbar-demo/

License
=======

Copyright 2012 minddust.com_

.. _minddust.com: http://www.minddust.com/

bootstrap-progressbar is published under Apache License, Version 2.0 (see LICENSE file).
{'fraction_non_alphanumeric': 0.140137577987522, 'fraction_numerical': 0.01279795232762758, 'mean_word_length': 2.732537313432836, 'pattern_counts': {'":': 0, '<': 23, '<?xml version=': 0, '>': 23, 'https://': 0, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1135025', 'n_tokens_mistral': 1751, 'n_tokens_neox': 1620, 'n_words': 555}