django-bootstrap-static

Bootstrap and optional Font Awesome static files ready for the picking.

Also ships the latest jQuery compatible with Bootstrap, for optional inclusion.

Install

pip install django-bootstrap-static

Configuration

To pickup Bootstrap static files, simply include 'bootstrap', and optionally 'fontawesome', in your INSTALLED_APPS:

INSTALLED_APPS = [
    # ...
    'bootstrap',
    'fontawesome',
]

Then you can include CSS and JavaScript as usual static resources, e.g. using {% static '...' %} in your base template as follows:

{% load static %}
<head>
    <link rel="stylesheet" href="{% static 'bootstrap/css/bootstrap.min.css' %}">
    <script defer src="{% static 'fontawesome/js/all.min.js' %}"></script>
</head>
<body>
    ...
    <script src="{% static 'bootstrap/js/jquery.min.js' %}"></script>
    <script src="{% static 'bootstrap/js/bootstrap.bundle.min.js' %}"></script>
</body>

Note that in the above code sample we use SVG powered Font Awesome, as recommended by their docs. You can use Font Awesome the classic way by replacing the <script ...> tag in the <head> section above by:

<link rel="stylesheet" href="{% static 'fontawesome/css/all.min.css' %}">

If you don’t use Bootstrap features that require Popper.js (e.g. dropdowns, popovers, tooltips) you can include bootstrap.min.js instead of the bundle to save a few kilobytes of bandwidth.

More details on integration may be available from each of the two projects:

Contribution

Occasionally, I forget to update this package with new bootstrap updates. Please feel free to submit a PR.

Sources and Procedures

Bootstrap: (all files from dist package)

Bootstrap website / Download ➜ drop into bootstrap/static/bootstrap/

jQuery: (compressed, uncompressed, map)

jQuery website / Download ➜ rename and mix into bootstrap/static/bootstrap/js/

Pick the latest version denoted as a dependency in bower.json (see Dependencies).

Font Awesome: (content of the on-server/ folder only)

Font Awesome website / Download Free ➜ drop into fontawesome/static/fontawesome/

Tests

Tests are great! And necessary. Please, add more. More is better! We use Tox.

pip install tox

Run all the linting and tests locally using Tox like this:

tox

tox list
tox -e package
tox -e py310,clean
tox -e format -- tests

Releases

To stay aligned with the Bootstrap release schedule we will keep version numbers of this app in sync with the bootstrap Major.Minor.Revision changes (semver). The additional version number will be added at the end to denote a new change within this package itself, e.g.

django-bootstrap-static==3.3.1.1 == Bootstrap 3.3.1 with an additional package change.

Release files for django-bootstrap-static 5.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-bootstrap-static 5.3.3
File	Size	Uploaded
django_bootstrap_static-5.3.3.tar.gz	5.7 MB	Jun 19, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-bootstrap-static 5.3.3
File	Interpreter	ABI	Platform	Reset
django_bootstrap_static-5.3.3-py3-none-any.whl 6.7 MB Jun 19, 2024	Python 3	none	any	Details

Total release size: 12.5 MB

Release files / django_bootstrap_static-5.3.3.tar.gz

Download URL	django_bootstrap_static-5.3.3.tar.gz
Size	5.7 MB
Tags	Source
SHA-256 checksum How to use checksums	`48477597c65fd6455ea7de96053bb66d5a13a5fe104d9a9b039383a2aae00e4c`
BLAKE2b-256 checksum How to use checksums	`7966bef5edab236e419297672adc218139bd617e20e66574fed24808a561e87c`
Upload date	Jun 19, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.0 CPython/3.12.3`

Release files / django_bootstrap_static-5.3.3-py3-none-any.whl

Download URL	django_bootstrap_static-5.3.3-py3-none-any.whl
Size	6.7 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`c7b97fd4b89cd7553075a206ca92fd9b392759e0b69b69629595e7037320855e`
BLAKE2b-256 checksum How to use checksums	`123a3971e2a28ae9076be3ecf99086b7ceef12111920b03fc095d749eab30714`
Upload date	Jun 19, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.0 CPython/3.12.3`