Django wit Tabler template
Project description
django-tabler-ng
Django with Tabler template.
This project transforms the Tabler dashboard into a Django package. It provides an extensible base template, error page templates, and the necessary static assets. django-tabler-ng is based on the
- Tabler release v1.0.0-beta12
- Django release 3.2 LTS
- Python relase 3.9
Installation
pip install django-tabler-ng
- Add
django_tabler_ng
to yourINSTALLED_APPS
Usage
Once installed, templates inside your application can extend django-tabler-ng's base template. A quick example:
{% extends "django_tabler_ng/base.html" %}
{% block extra_css %}
{# add your custom css here #}
{% endblock extra_css %}
{% block content %}
<h1>This is a Heading</h1>
<p>This is a paragraph</p>
<p>{{ some_context_variable }}</p>
{% endblock content %}
{% block extra_js %}
<script>
{# add your custom javascript here #}
</script
{% endblock extra_js %}
Need some inspiration? Check out the templates provided by the original project.
Missing a title in the browser window?
django-tabler-ng's base template adds your site's name to the browser's titlebar using Django's Sites framework. Follow these steps for setup:
- Add a
SITE_ID
value to your application's settings file - Add
'django.contrib.sites'
toINSTALLED_APPS
- Add
'django.contrib.sites.middleware.CurrentSiteMiddleware'
toMIDDLE_WARE
- Run
python manage.py migrate
if necessary - Inside your application's
django_site
database table, update the record that cooresponds to theSITE_ID
value with an appropriate name and domain. A custom migration might be helpful.
Missing a favicon?
To load a favicon, create an img/
folder inside your application's static
directory.
Place favicon.ico
inside, and the icon will be loaded by the base template.
Custom error views
django-tabler-ng overrides Django's default error views
by rendering a custom error template. Your application can access these by
adding the following to your applications' urls.py
file:
handler400 = 'django_tabler_ng.views.error400'
handler403 = 'django_tabler_ng.views.error403'
handler404 = 'django_tabler_ng.views.error404'
handler500 = 'django_tabler_ng.views.error500'
Inspiration from @rbennett91/django-tabler.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_tabler_ng-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 06fd6884ab3edcb43bf41fbefa1bca239b1d3cb208ae317d82f37190780494e8 |
|
MD5 | cfc7aeb57b6fcd5df508581cfb2ff829 |
|
BLAKE2b-256 | 8b0447e408541ec8848c9d43b84b00cb02a4961b99f7f0e42b0e3e80221cd927 |