=========
Templates
=========

You can customize the output of ``django-bootstrap5`` by writing your own templates. These templates are available:


django_bootstrap5/field_help_text_and_errors.html
-------------------------------------------------

This renders the help text and error of each field.

Variable ``help_text_and_errors`` contains an array of strings.


django_bootstrap5/form_errors.html
----------------------------------

This renders the non field errors of a form.

Variable ``errors`` contains an array of strings.


django_bootstrap5/messages.html
-------------------------------

This renders the Django messages variable.

Variable ``messages`` contains the messages as described in https://docs.djangoproject.com/en/dev/ref/contrib/messages/#displaying-messages

``messages`` is passed through three built-in filters

`safe <https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std:templatefilter-safe>`

`urlize <https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std:templatefilter-urlize>`

`linebreaksbr <https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std:templatefilter-linebreaksbr>`

Other
-----

There are two more templates, ``django_bootstrap5/bootstrap5.html`` and ``django_bootstrap5/pagination.html``. You should consider these private for now, meaning you can use them but not modify them.