Metadata-Version: 2.1
Name: django-bootstrap3
Version: 13.0.0
Summary: Bootstrap 3 support for Django projects
Home-page: https://github.com/zostera/django-bootstrap3
License: BSD-3-Clause
Keywords: django,django-bootstrap3,bootstrap3,bootstrap
Author: Dylan Verheul
Author-email: dylan@zostera.nl
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Dist: django (>=2.2,<4.0)
Requires-Dist: importlib-metadata (>=1.5.0,<2.0.0); python_version < "3.8"
Project-URL: Documentation, https://django-bootstrap3.readthedocs.io/
Project-URL: Repository, https://github.com/zostera/django-bootstrap3
Description-Content-Type: text/x-rst

======================
Bootstrap 3 for Django
======================

.. image:: https://travis-ci.org/dyve/django-bootstrap3.svg
    :target: https://travis-ci.org/dyve/django-bootstrap3

.. image:: https://readthedocs.org/projects/django-bootstrap3/badge/?version=latest
    :target: https://django-bootstrap3.readthedocs.io/en/latest/

.. image:: https://img.shields.io/pypi/v/django-bootstrap3.svg
    :target: https://pypi.org/project/django-bootstrap3/
    :alt: Latest PyPI version

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/ambv/black

.. image:: https://coveralls.io/repos/github/dyve/django-bootstrap3/badge.svg
    :target: https://coveralls.io/r/dyve/django-bootstrap3


Bootstrap 3 integration 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.


Requirements
------------

- Python >= 3.6, Django >= 2.2 (see also https://docs.djangoproject.com/en/dev/faq/install/#faq-python-version-support)

Need older versions?
++++++++++++++++++++

This is our history of dropping support for Python and Django versions. Note that this information is "as is", and you should really update to newer Python and Django versions. Using unsupported versions will lead to security risks and broken software.

- The latest version supporting Python 3.5 Django 2.1 is 12.x.x.
- The latest version supporting Django 1.11 and 2.0 is 11.x.x.
- The latest version supporting Django < 1.11 is 9.x.x.
- The latest version supporting Python 2.6 and Django < 1.8 is 6.x.x.


Installation
------------

1. Install using pip:

   ``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``:

   ``'bootstrap3',``

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


Example template
----------------

   .. code:: Django

    {% load bootstrap3 %}

    {# 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">
                {% bootstrap_icon "star" %} Submit
            </button>
        {% endbuttons %}
    </form>


Documentation
-------------

The full documentation is at https://django-bootstrap3.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/dyve/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 & Development lead: `Dylan Verheul <https://github.com/dyve>`_.

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

Please see `AUTHORS.rst <AUTHORS.rst>`_ for a list of contributors.

