Skip to main content

Base HTML templates for DBCA Django projects

Project description

DBCA Django web template

This project consists of a basic Django application containing HTML templates that provide a starting point for web applications used by the Department. The base template consists of a mobile-friendly HTML5 template with a fixed top navbar, plus static assets. The project also contains functional examples of login and logged out templates.

The base templates are based upon HTML5 Boilerplate.

Development

The recommended way to set up this project for development is using uv to install and manage a Python virtual environment. With uv installed, install the required Python version (see pyproject.toml). Example:

uv python install 3.12

Change into the project directory and run:

uv python pin 3.12
uv sync

Activate the virtualenv like so:

source .venv/bin/activate

Run unit tests using pytest (or tox, to test against multiple Python versions):

pytest -sv
tox -v

Releases

Tagged releases are built and pushed to PyPI automatically using a GitHub workflow in the project. Update the project version in pyproject.toml and tag the required commit with the same value to trigger a release. Packages can also be built and uploaded manually, if desired.

Build the project locally using uv, publish to the PyPI registry using the same tool if you require:

uv build
uv publish

Installation

  1. Install via pip: pip install webtemplate-dbca.
  2. Add 'webtemplate_dbca' to INSTALLED_APPS.
  3. Ensure that the staticfiles application is included and configured correctly.
  4. (Optional) Ensure that you have defined the following named URLs: login and logout (this requirement can be overriden, see below).
  5. Extend the included base template by placing the following at the head of your own templates, e.g. {% extends "webtemplate_dbca/base_b4.html" %}
  6. Place page content within the required blocks (see below).

Included CSS and JavaScript

The base_b4/base_b5 templates include the following CSS and JavaScript assets:

  • Modernizr (HTML5 polyfills)
  • Bootstrap 4 or 5 (CSS & JS)
  • jQuery (base/base_b4 templates)

Additional styling can be included using the extra_style or extra_js blocks, like so::

{% load static from staticfiles %}

{% block extra_style %}
{{ block.super }}
<link rel="stylesheet" href="{% static 'css/custom.css' %}">
{% endblock %}

You can also overide the base_style and base_js blocks completely to use different CSS or JS libraries. Note that you will also need to replace the top_navbar block contents if you replace the base Bootstrap CSS & JS.

The version of jQuery which is loaded in the base is by default a slimmed-down minimal version of the library. To include a different specific version, override the jquery_version block. Example::

{% block jquery_version %}
<script src="https://code.jquery.com/jquery-3.4.1.js"></script>
{% endblock %}

NOTE: There is no jQuery loaded with the base_b5 template, as it was dropped as a requirement of Bootstrap.

Template blocks

The base template contains a number of block tags that are used to render the content of your project. The main template content blocks are as follows:

  • navbar_links - used to define navigation links in the top navbar.
  • navbar_auth - used to display either a Login or Logout link.
  • page_content - used to contain the page's main content.
  • page_footer - used to contain a page footer area.

Note that the navbar_auth block contains {% url %} templatetags with named URLs called login and logout. If this is not required or inappropriate for your project, simply override the navbar_auth block in a base template like so::

{% block navbar_auth %}{% endblock %}

In addition, a number of context variables are defined:

  • page_title - used to populate the page <title> tags.
  • site_title - used to populate the projects's title in the top navbar.
  • site_acronym - used to populate a shorter title in the navbar (B4 template).

Context variables should be passed to templates in every view.

Bootstrap 4 & 5 examples

The following examples apply to the base_b4.html and base_b5.html templates.

To extend the base template with an optional row to display alert messages plus a shaded footer div, try the following (further page content is then injected to the page_content_inner block)::

{% extends "webtemplate_dbca/base_b4.html" %}

{% block extra_style %}
<style>
    .footer {background-color: lightgrey}
</style>
{% endblock %}

{% block page_content %}
    <div class="container-fluid">
        <!-- Messages  -->
        {% if messages %}
        <div class="row">
            <div class="col">
                {% for message in messages %}
                <div class="alert{% if message.tags %} alert-{{ message.tags }}{% endif %}">
                    {{ message|safe }}
                </div>
                {% endfor %}
            </div>
        </div>
        {% endif %}

        <div class="row">
            <div class="col">
                {% block page_content_inner %}{% endblock %}
            </div>
        </div>
    </div>
{% endblock %}

{% block page_footer %}
<footer class="footer mt-auto py-3">
    <div class="container-fluid">
        <div class="row">
            <div class="col">
                <small class="float-right">&copy; Department of Biodiversity, Conservation and Attractions</small>
            </div>
        </div>
    </div>
</footer>
{% endblock page_footer %}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

webtemplate_dbca-1.8.2.tar.gz (48.6 kB view details)

Uploaded Source

Built Distribution

webtemplate_dbca-1.8.2-py3-none-any.whl (53.4 kB view details)

Uploaded Python 3

File details

Details for the file webtemplate_dbca-1.8.2.tar.gz.

File metadata

  • Download URL: webtemplate_dbca-1.8.2.tar.gz
  • Upload date:
  • Size: 48.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.6.15

File hashes

Hashes for webtemplate_dbca-1.8.2.tar.gz
Algorithm Hash digest
SHA256 55899634c19ad7e862355616ee2592d18619e48e2797a2db6ef6f8a073ed8e17
MD5 98659f7896319e1ec08a91e78851aeda
BLAKE2b-256 eecdeda9f608b9d9d9a63924817bd4fb0f38cf2759d327367e644b1625c2bc60

See more details on using hashes here.

File details

Details for the file webtemplate_dbca-1.8.2-py3-none-any.whl.

File metadata

File hashes

Hashes for webtemplate_dbca-1.8.2-py3-none-any.whl
Algorithm Hash digest
SHA256 70bc7f5ec347d38cb86a5b50e8a456f9ca95b378e420316b6428a83bae60f0cf
MD5 0300a817f1a2a589386b49e011782bf7
BLAKE2b-256 0d1e27be81a01460309f2d775e90ad251674a7031f83fb78c9c00df9da40c551

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page