/django-bootstrap3

Bootstrap 3 integration with Django.

Primary LanguagePythonOtherNOASSERTION

django-bootstrap3

https://travis-ci.org/dyve/django-bootstrap3.png?branch=master https://badge.fury.io/py/django-bootstrap3.png https://pypip.in/d/django-bootstrap3/badge.png

Bootstrap support for Django projects

gittip

Documentation

The full documentation is at http://django-bootstrap3.readthedocs.org/.

Quickstart

  1. Install using pip:

    pip install django-bootstrap3

    Alternatively, you can install download or clone this repo and call pip install -e ..

  2. Add to INSTALLED_APPS in your settings.py:

    'bootstrap3',

  3. In your templates, load the bootstrap3 library and use the bootstrap_* tags:

    {% load bootstrap3 %}
    
    {# Load CSS and JavaScript #}
    
    {% bootstrap_css %}
    {% bootstrap_javascript %}
    
    {# Display django.contrib.messages as Bootstrap alerts #}
    {% bootstrap_messages %}
    
    {# Display a form #}
    
    <form action="/url/to/submit/" method="post" class="form">
        {% csrf_token %}
        {% bootstrap_form form %}
        {% buttons %}
            <button type="submit" class="btn btn-primary">
                {% bootstrap_icon "star" %} Submit
            </button>
        {% endbuttons %}
    </form>

Features

Define your forms in Django, use django-bootstrap3 to render them in Bootstrap. That's the dream.

Requirements

  • Python 2.6, 2.7 and 3.3
  • Django >= 1.4

Contributions and pull requests for other Django and Python versions are welcome.

Bugs and requests

If you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.

https://github.com/dyve/django-bootstrap3/issues

License

You can use this under Apache 2.0. See LICENSE file for details.

Author

My name is Dylan Verheul, you can reach me at dylan@dyve.net or follow me on Twitter (http://twitter.com/dyve). If you like this project, you can support me on GitTip.