https://github.com/zostera/django-bootstrap3
Bootstrap 3 integration with Django.
https://github.com/zostera/django-bootstrap3
bootstrap3 django python
Last synced: 7 days ago
JSON representation
Bootstrap 3 integration with Django.
- Host: GitHub
- URL: https://github.com/zostera/django-bootstrap3
- Owner: zostera
- License: bsd-3-clause
- Created: 2013-08-13T13:48:04.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2025-03-17T10:42:21.000Z (30 days ago)
- Last Synced: 2025-04-01T17:15:52.789Z (14 days ago)
- Topics: bootstrap3, django, python
- Language: Python
- Homepage: http://django-bootstrap3.readthedocs.org/
- Size: 1.31 MB
- Stars: 2,337
- Watchers: 102
- Forks: 681
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-django-cn - django-bootstrap3, star:1731 - 以 Django 的方式，在 Django 模板中使用 Bootstrap。 (表单)
- best-of-web-python - GitHub - 1% open · ⏱️ 25.04.2024): (Django Utilities)
- awesome-python-resources - GitHub - 2% open · ⏱️ 22.08.2022): (表单)
README
# django-bootstrap3
[](https://github.com/zostera/django-bootstrap3/actions?workflow=test)
[](https://coveralls.io/github/zostera/django-bootstrap3?branch=main)
[](https://pypi.python.org/pypi/django-bootstrap3)
Bootstrap 3 for Django.
## Goal
The goal of this project is to seamlessly blend Django and Bootstrap 3.
## Roadmap
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](https://github.com/zostera/django-bootstrap4).
For Bootstrap 5, please refer to our dedicated package: [django-bootstrap5](https://github.com/zostera/django-bootstrap5).
For icons, we recommend our dedicated package: [django-icons](https://github.com/zostera/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
1. Install using pip:
```shell script
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`:
```python
INSTALLED_APPS = (
# ...
"bootstrap3",
# ...
)
````
3. In your templates, load the `bootstrap3` library and use the `bootstrap_*` tags:
## Example template
```djangotemplate
{% load bootstrap3 %}
{# Display a form #}
{% csrf_token %}
{% bootstrap_form form %}
{% buttons %}
Submit
{% endbuttons %}
```
Example app
-----------
An example app is provided in `example`. You can run it with `make example`.
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](LICENSE) file for details.
Author
------
Developed and maintained by [Zostera](https://zostera.nl).
Original author: [Dylan Verheul](https://github.com/dyve).
Thanks to everybody that has contributed pull requests, ideas, issues, comments and kind words.
Please see [AUTHORS](AUTHORS) for a list of contributors.