django-bootstrap 4
Bootstrap 4 integration for Django.
Goal
The goal of this project is to seamlessly blend Django and Bootstrap 4.
Requirements
Python 3.6 or newer with Django >= 2.2 or newer.
Documentation
The full documentation is at https://django-bootstrap4.readthedocs.io/
Installation
-
Install using pip:
pip install django-bootstrap4
Alternatively, you can install download or clone this repo and call
pip install -e .
. -
Add to
INSTALLED_APPS
in yoursettings.py
:INSTALLED_APPS = ( # ... "bootstrap4", # ... )
-
In your templates, load the
bootstrap4
library and use thebootstrap_*
tags:
Example template
{% load bootstrap4 %}
{# 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">Submit</button>
{% endbuttons %}
</form>
Demo
A demo app is provided in demo
. You can run it from your virtualenv with python manage.py runserver
.
Bugs and suggestions
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/zostera/django-bootstrap4/issues
License
You can use this under BSD-3-Clause. See LICENSE file for details.
Author
Developed and maintained by Zostera.
Original author: Dylan Verheul.
Thanks to everybody that has contributed pull requests, ideas, issues, comments and kind words.
Please see AUTHORS.md for a list of contributors.