/django-bootstrap4

Bootstrap 4 integration with Django.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Bootstrap 4 for Django

Write Django as usual, and let django-bootstrap4 make template output into Bootstrap 4 code.

Latest PyPI version Number of PyPI downloads per month

Requirements

  • Django >= 1.11 (and compatible Python version)

Installation

  1. Install using pip:

    pip install django-bootstrap4

    Alternatively, you can install download or clone this repo and call pip install -e ..

  2. Add to INSTALLED_APPS in your settings.py:

    'bootstrap4',

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

This app will soon require Django 1.8+, python 2.7+. Thanks for understanding.

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>

Documentation

The full documentation is at http://django-bootstrap.readthedocs.org/.

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 & Development lead: Dylan Verheul.

Thanks to everybody that has contributed pull requests, ideas, issues, comments and kind words.

Please see AUTHORS.rst for a list of contributors.