Skip to main content

Bootstrap support for Django projects

Project description

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.

History

3.2.0 (2014-03-11)

  • support for addons

3.1.0 (2014-03-03)

  • improve compatibility with Django < 1.5

3.0.0 (2014-02-28)

  • added support for themes (fix issue #74)

  • show inline form errors in field title (fix issue #81)

  • fixed bugs in demo application

  • update to newest Bootstrap (fix issue #83)

2.6.0 (2014-02-20)

  • new setting set_required to control setting of HTML required attribute (fix issue #76)

2.5.6 (2014-01-23)

  • project refactored

  • added skeleton for creating documentation (fix issue #30)

  • fixed FileField issues

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-bootstrap3-3.2.0.tar.gz (20.5 kB view details)

Uploaded Source

File details

Details for the file django-bootstrap3-3.2.0.tar.gz.

File metadata

File hashes

Hashes for django-bootstrap3-3.2.0.tar.gz
Algorithm Hash digest
SHA256 fe04643688e94709715fdd9996238bd20ee40fce55446b8a565cc056db6f3a9a
MD5 3982811cf6caa5de5fdcf0daca208535
BLAKE2b-256 f3fadfc5a3bea8c80e1c842ec2a8920b4eac1a1d95ba4aefb740fea67468618b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page