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

Bootstrap for Django
https://github.com/zostera/django-bootstrap

Last synced: 12 months ago
JSON representation

Bootstrap for Django

• Host: GitHub
• URL: https://github.com/zostera/django-bootstrap
• Owner: zostera
• License: bsd-3-clause
• Created: 2020-03-08T06:33:02.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2023-02-28T00:00:17.000Z (almost 3 years ago)
• Last Synced: 2025-01-14T03:13:30.593Z (about 1 year ago)
• Language: Python
• Size: 129 KB
• Stars: 0
• Watchers: 4
• Forks: 0
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Authors: AUTHORS

Awesome Lists containing this project

README

          
# django-bootstrap 4

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

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

[![Latest PyPI version](https://img.shields.io/pypi/v/django-bootstrap4.svg)](https://pypi.python.org/pypi/django-bootstrap4)

[![Any color you like](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)

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

1. Install using pip:

    ```shell script

    pip install django-bootstrap

    ```

   

   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 = (

       # ...

       "django_bootstrap",

       # ...

   )

   ````

3. In your templates, load the `bootstrap4` library and use the `bootstrap_*` tags:

## Example template

```djangotemplate

{% load bootstrap4 %}

{# Display a form #}

    {% csrf_token %}

    {% bootstrap_form form %}

    {% buttons %}

        Submit

    {% endbuttons %}

```

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](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.