Skip to main content

Bootstrap support for Django projects

Project description

============================
Welcome to django-bootstrap3
============================

.. image:: https://travis-ci.org/dyve/django-bootstrap3.png?branch=master
:target: https://travis-ci.org/dyve/django-bootstrap3

.. image:: https://coveralls.io/repos/dyve/django-bootstrap3/badge.png?branch=develop
:target: https://coveralls.io/r/dyve/django-bootstrap3?branch=develop

.. image:: https://badge.fury.io/py/django-bootstrap3.png
:target: http://badge.fury.io/py/django-bootstrap3

.. image:: https://pypip.in/d/django-bootstrap3/badge.png
:target: https://crate.io/packages/django-bootstrap3?version=latest


Use Bootstrap in your Django templates, the Django way.


Installation
------------

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:


Example template
----------------

.. code:: Django

{% load bootstrap3 %}

{# 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>


Documentation
-------------

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


Requirements
------------

- Python 2.6, 2.7, 3.2 or 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
<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 <https://www.gittip.com/dyve/>`_.




History
-------


4.9.2 (2014-08-11)
++++++++++++++++++

* Fixed bug causing problems with setting classes for horizontal forms


4.10.0 (2014-08-12)
+++++++++++++++++++

* Template tag `bootstrap_icon` now supports a `title` parameter


4.9.1 (2014-08-10)
++++++++++++++++++

* Fixed test for Django 1.4


4.9.0 (2014-08-09)
++++++++++++++++++

* New parameter `href` for `bootstrap_button`, if provided will render `a` tag instead of `buttonz tag


4.8.2 (2014-07-10)
++++++++++++++++++

* Internal fixes to master branch


4.8.1 (2014-07-10)
++++++++++++++++++

* Make extra classes override bootstrap defaults


4.8.0 (2014-07-10)
++++++++++++++++++

* Introduced new setting `set_placeholder`, default True


4.7.1 (2014-07-07)
++++++++++++++++++

* Fixed rendering of various sizes (as introduced in 4.7.0)
* Upgrade to Bootstrap 3.2.0 as default version


4.7.0 (2014-06-04)
++++++++++++++++++

* `size` option added to formsets, forms, fields and buttons


4.6.0 (2014-05-22)
++++++++++++++++++

* new `bootstrap_formset_errors` tag


4.5.0 (2014-05-21)
++++++++++++++++++

* bug fixes in formsets
* new formset renderer
* new `bootstrap_form_errors` tag


4.4.2 (2014-05-20)
++++++++++++++++++

* documentation now mentions templates


4.4.1 (2014-05-08)
++++++++++++++++++

* bug fixes
* documentation fixes
* test coverage on coveralls.io


4.4.0 (2014-05-01)
++++++++++++++++++

* added `bootstrap_alert` template tag


4.3.0 (2014-04-25)
++++++++++++++++++

* added `required_css_class` and `error_css_class` as optional settings (global) and parameters (form and field rendering)


4.2.0 (2014-04-06)
++++++++++++++++++

* moved styling of form level errors to template
* bug fixes


4.1.1 (2014-04-06)
++++++++++++++++++

* moved all text conversions to text_value


4.1.0 (2014-04-05)
++++++++++++++++++

* typo fix and internal branching changes


4.0.3 (2014-04-03)
++++++++++++++++++

* fixed checkbox label bug in vertical and inline forms


4.0.2 (2014-04-02)
++++++++++++++++++

* fixed bug in vertical form rendering


4.0.1 (2014-03-29)
++++++++++++++++++

* fixed unicode bug and added unicode label to tests


4.0.0 (2014-03-28)
++++++++++++++++++

* use renderer classes for generating HTML
* several bug fixes


3.3.0 (2014-03-19)
++++++++++++++++++

* use Django forms css classes for indicating required and error on fields


3.2.1 (2014-03-16)
++++++++++++++++++

* improved form rendering


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-4.10.0.tar.gz (25.2 kB view hashes)

Uploaded Source

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