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.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
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.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
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.9.2.tar.gz
(25.2 kB
view details)
File details
Details for the file django-bootstrap3-4.9.2.tar.gz.
File metadata
- Download URL: django-bootstrap3-4.9.2.tar.gz
- Upload date:
- Size: 25.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2b115ae593ab4060ce3427d7c233e376d5cd394a23abca58309c2f084e1f18ff |
|
| MD5 | 80c46746dbedbccf0f4c5df850577733 |
|
| BLAKE2b-256 | b517a03f7cf143a47db538562d3fa5c53de767c945dd4278ed9a02ac0eefe4d4 |
