Integrate the French government Design System into a Django app
Project description
Django-DSFR
Django-DSFR is a Django app to integrate the French government Design System (“Système de design de l’État français”).
This app was created as a part of Open Collectivités and is very much a work in progress. See the documentation (in French) for details.
Django-DSFR (partly) implements the version 1.9.2 of the DSFR.
Requirements
Tested with Python 3.7 to 3.10 and Django 3.2.5 to 4.1.16. Per vermin, it should work with Python >= 3.0, and it should work with old versions of Django too.
Quick start
Install with
pip install django-dsfr
.Add “widget_tweaks” and “dsfr” to INSTALLED_APPS in your settings.py like this, before the app you want to use it with:
INSTALLED_APPS = [ ... "widget_tweaks" "dsfr", <your_app> ]
Add the following info in the TEMPLATES section in your settings.py so that the choice forms work:
TEMPLATES = [ { [...] "DIRS": [ os.path.join(BASE_DIR, "dsfr/templates"), os.path.join(BASE_DIR, "templates"), ], }, ]
Add the following FORM_RENDERER in settings.py so that the choice forms work:
FORM_RENDERER = "django.forms.renderers.TemplatesSetting"
(Optional) Add the context processor to your settings.py and create an instance of “DsfrConfig” in the admin panel:
TEMPLATES = [ { [...] "OPTIONS": { "context_processors": [ [...] "dsfr.context_processors.site_config", ], }, }, ]
Include the tags in your base.html file (see example file at https://github.com/entrepreneur-interet-general/django-dsfr/blob/main/example_app/templates/example_app/base.html)
Start the development server and visit http://127.0.0.1:8000/
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_dsfr-0.14.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9914329d17fd238a4ca9d19fc79ed869572219ee18e282e6f4a9071f92eb6e8e |
|
MD5 | c5a7f1d646fc42bede518b11a0edbd73 |
|
BLAKE2b-256 | 37d3ea665e55ee1fbcb4944f12b4cb6a6bbe03c268cbd03dacd789cf3c90761b |