https://github.com/zostera/django-bootstrap3

Bootstrap 3 integration with Django.
https://github.com/zostera/django-bootstrap3

bootstrap3 django python

Last synced: 8 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 (about 11 years ago)
• Default Branch: main
• Last Pushed: 2024-10-25T10:28:26.000Z (14 days ago)
• Last Synced: 2024-10-29T14:52:00.868Z (10 days ago)
• Topics: bootstrap3, django, python
• Language: Python
• Homepage: http://django-bootstrap3.readthedocs.org/
• Size: 1.2 MB
• Stars: 2,343
• Watchers: 103
• Forks: 684
• Open Issues: 4
• 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。 (表单)
• awesome-python-resources - GitHub - 2% open · ⏱️ 22.08.2022): (表单)
• best-of-web-python - GitHub - 1% open · ⏱️ 25.04.2024): (Django Utilities)

README

        
# django-bootstrap3

[![CI](https://github.com/zostera/django-bootstrap3/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/zostera/django-bootstrap3/actions?workflow=test)

[![Coverage Status](https://coveralls.io/repos/github/zostera/django-bootstrap3/badge.svg?branch=main)](https://coveralls.io/github/zostera/django-bootstrap3?branch=main)

[![Latest PyPI version](https://img.shields.io/pypi/v/django-bootstrap3.svg)](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.

- Want to use Bootstrap 4 in Django? See https://github.com/zostera/django-bootstrap4.

- Want to use Bootstrap 5 in Django? See https://github.com/zostera/django-bootstrap5.

- Need icons in your Django project? Use https://github.com/zostera/django-icons.

## Status

This project will receive updates for supported Python and Django versions. Otherwise, we will probably not accept any changes.

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