django-bootstrap3
Bootstrap 3 for Django.
Goal
The goal of this project is to seamlessly blend Django and Bootstrap 3.
Maintenance Mode
Bootstrap 3 has been superseded by Bootstrap 4, which has since been superseded by Bootstrap 5. As a result, this package is now in maintenance mode and will only receive bug fixes and security updates. No new features or enhancements will be added. We recommend that new projects use Bootstrap 5 and encourage existing projects to consider migrating when feasible.
For Bootstrap 4, please refer to our dedicated package: django-bootstrap4.
For Bootstrap 5, please refer to our dedicated package: django-bootstrap5.
To migrate, see From django-bootstrap3 in the django-bootstrap5 migration guide. It covers the settings that disappear or change meaning, renamed tag arguments such as size="large", and the removed {% buttons %} tag.
For icons, we recommend our dedicated package: django-icons.
Requirements
This package requires a combination of Python and Django that is currently supported.
See "Supported Versions" on https://www.djangoproject.com/download/.
Documentation
The full documentation is at https://django-bootstrap3.readthedocs.io/
Installation
- Install using pip:
shell script
pip install django-bootstrap3
Alternatively, you can install download or clone this repo and call pip install -e ..
- Add to
INSTALLED_APPS in your settings.py:
python INSTALLED_APPS = (
# ...
"bootstrap3",
# ...
)
3. In your templates, load the bootstrap3 library and use the bootstrap_* tags:
Example template
{# Display a form #}
## Example app
An example app is provided in the folder example. You can run the example app with this command:
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-bootstrap3/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 for a list of contributors.