Tema Bootstrap 5 per applicazioni Django dell'AGESCI Campania, con palette ufficiale e personalizzazione per branca.

Navigation

Verified details

These details have been verified by PyPI
Project links
Owner
GitHub Statistics

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT License (MIT)
  • Author: AGESCI Campania
  • Tags agesci , bootstrap , django , scout , theme
  • Requires: Python >=3.12
  • Provides-Extra: icons
Classifiers
Report project as malware

Project description

django-agesci-theme

build License: MIT Python Django Bootstrap uv Version Code style: Black

Tema Bootstrap 5 riusabile per le applicazioni Django dell'AGESCI Campania.

Fornisce un base.html pronto all'uso, navbar, footer sticky, breadcrumb e sub-navbar brandizzati, la palette ufficiale del Manuale Immagine Coordinata AGESCI 2011, gli emblemi associativi e regionali, e la personalizzazione per branca tramite un singolo parametro.

Ambito Colore dominante data-branca
Generico (default) Blu/Azzurro generico
Capi / Comunità Capi Viola capi
Lupetti/Coccinelle (L/C) Giallo lc
Esploratori/Guide (E/G) Verde eg
Rover/Scolte (R/S) Rosso rs

Il colore viene applicato rimappando le CSS custom properties di Bootstrap, in funzione dell'attributo data-branca sul tag <html>. Nessun ricompilo necessario: basta cambiare una setting.

Installazione

Il pacchetto è disponibile su PyPI.

Con uv (consigliato)

uv add django-agesci-campania-theme

Con pip

pip install django-agesci-campania-theme

Da GitHub (ultima versione non rilasciata)

uv add "git+https://github.com/AGESCI-Campania/django-agesci-campania-theme.git"
pip install "git+https://github.com/AGESCI-Campania/django-agesci-campania-theme.git"

Configurazione

In settings.py:

INSTALLED_APPS = [
    # ...
    "agesci_theme",
]

TEMPLATES = [{
    "BACKEND": "django.template.backends.django.DjangoTemplates",
    "DIRS": [],
    "APP_DIRS": True,
    "OPTIONS": {
        "context_processors": [
            # ... quelli di default ...
            "agesci_theme.context_processors.agesci_theme",
        ],
    },
}]

# --- Personalizzazione tema (tutte opzionali) ---
AGESCI_THEME_BRANCA = "eg"            # generico | capi | lc | eg | rs | viola
AGESCI_THEME_NOME = "Zona Vesuvio"     # mostrato in navbar/footer/title
# Navbar con testo scuro: utile per branca chiara (es. lc = giallo)
AGESCI_THEME_NAVBAR_TESTO_SCURO = False

# Loghi/favicon personalizzati (path relativi a STATIC).
# Se omessi usano gli asset AGESCI Campania inclusi nel pacchetto.
# AGESCI_THEME_LOGO_NAVBAR = "mia_app/img/logo_zona.svg"
# AGESCI_THEME_FAVICON_32 = "mia_app/img/favicon32.png"

Assicurati di avere lo static configurato:

STATIC_URL = "static/"
# in produzione:  python manage.py collectstatic

Uso nei template

{% extends "agesci_theme/base.html" %}
{% load agesci_tags %}

{% block title %}Home — {{ agesci_theme_nome }}{% endblock %}

{% block nav_items %}
  <li class="nav-item"><a class="nav-link" href="/">Home</a></li>
  <li class="nav-item"><a class="nav-link" href="/eventi/">Eventi</a></li>
{% endblock %}

{% block content %}
  <h1>Benvenuti</h1>
  <button class="btn btn-primary">Pulsante in colore branca</button>

  {# Emblema di una Zona Campania #}
  {% emblema_zona "vesuvio" css_class="img-fluid" %}

  {# Badge che segue il colore della branca corrente #}
  <span class="badge {% branca_bg %}">Branca</span>
{% endblock %}

Blocchi disponibili in base.html

Blocco Posizione
title <title> della pagina
extra_head fine del <head>, prima di </head>
navbar barra di navigazione principale
brand_url URL del brand nella navbar
brand_text testo del brand nella navbar
nav_items voci <li> all'interno del menu
breadcrumb barra breadcrumb (sotto la navbar)
subnav barra di navigazione secondaria
main_class classi CSS del tag <main>
messages messaggi Django (alert Bootstrap)
content contenuto principale della pagina
footer footer della pagina
footer_text testo al centro del footer
footer_links link a destra nel footer
extra_js script prima di </body>

Layout applicazione (viewport fisso)

Il base.html imposta body { height: 100vh; overflow: hidden } e main { flex-grow: 1; min-height: 0; overflow-y: auto } tramite il CSS del tema. Il risultato è un layout a viewport fisso: navbar, breadcrumb, sub-navbar e footer occupano la loro altezza naturale e rimangono sempre visibili; solo il <main> scorre internamente quando il contenuto supera lo spazio disponibile.

Breadcrumb

Passa breadcrumb_items dal contesto della view (lista di dizionari {"label": "...", "url": "..."}). L'ultimo elemento è automaticamente marcato come active senza link.

# views.py
def my_view(request):
    return render(request, "mia_app/pagina.html", {
        "breadcrumb_items": [
            {"label": "Home", "url": "/"},
            {"label": "Sezione", "url": "/sezione/"},
            {"label": "Pagina corrente", "url": ""},
        ]
    })

In alternativa, sovrascrivi il blocco {% block breadcrumb %} nel template.

Sub-navbar

Funziona come la breadcrumb ma mostra una barra di navigazione secondaria con pill colorate secondo la branca. Passa subnav_items (lista di {"label": "...", "url": "...", "active": True/False}):

"subnav_items": [
    {"label": "Panoramica", "url": "/sezione/", "active": True},
    {"label": "Elenco",     "url": "/sezione/lista/", "active": False},
]

Icone Bootstrap (opzionale)

Supporto tramite django-bootstrap-icons. Installazione con l'extra icons:

uv add "django-agesci-campania-theme[icons]"
# oppure
pip install "django-agesci-campania-theme[icons]"

Aggiungi in settings.py:

INSTALLED_APPS = [..., "agesci_theme", "django_bootstrap_icons"]

# Consigliato: abilita la cache per non scaricare gli SVG a ogni richiesta
BS_ICONS_CACHE = BASE_DIR / ".bs-icons-cache"

Uso nei template:

{% load bootstrap_icons %}
{% bs_icon "house" %}
{% bs_icon "calendar-event" size="1.5em" %}

Template tag ({% load agesci_tags %})

  • {% emblema_zona "napoli" css_class="..." alt="..." %} — <img> dell'emblema di Zona.
  • {% zone_disponibili %} — lista delle chiavi di zona.
  • {% branca_bg %} — classe CSS di sfondo nel colore della branca corrente.

Zone disponibili: caserta, faito, felix, hirpinia, liternum, napoli, poseidonia, salerno, samnium, vesuvio, volturno.

Classi utility palette

bg-ag-viola, bg-ag-azzurro, bg-ag-giallo-lc, bg-ag-verde-eg, bg-ag-rosso-rs, bg-ag-giallo-oro e i corrispettivi text-ag-*.

Progetto demo

Il repository include un progetto Django di esempio che mostra navbar, breadcrumb, sub-navbar, footer sticky, palette e zone. Per avviarlo:

# 1. Clona il repository e installa le dipendenze (crea .venv automaticamente)
git clone https://github.com/AGESCI-Campania/django-agesci-campania-theme.git
cd django-agesci-campania-theme
uv sync

# 2. Crea il database e avvia il server
uv run python example_project/manage.py migrate
uv run python example_project/manage.py runserver

Apri http://127.0.0.1:8000/ nel browser.

Per provare le diverse branche modifica AGESCI_THEME_BRANCA in example_project/config/settings.py (generico, capi, lc, eg, rs) e ricarica la pagina — nessun ricompilo necessario.

Sviluppo del tema (modificare i colori/SCSS)

Il CSS compilato è già committato, quindi chi installa il pacchetto non ha bisogno di Sass. Serve solo se vuoi modificare lo SCSS.

npm install
npm run build:css      # rigenera agesci.css e agesci.min.css
npm run watch:css      # ricompila live durante lo sviluppo

I sorgenti sono in agesci_theme/static/agesci_theme/scss/: _palette.scss (colori del manuale), _branche.scss (mappa ambiti→colore), _bootstrap-overrides.scss (componenti).

Palette ufficiale

Estratta dal Manuale Immagine Coordinata AGESCI 2011, sez. 7.

Colore Pantone HEX
Viola 527C #7A1E99
Viola scuro 072C #622599
Giallo oro 123C #FFCC1E
Azzurro 279C #6689CC
Giallo L/C 109C #F9D616
Verde E/G 363C #3D8E33
Rosso R/S 032C #EF3340 *

* Il manuale 2011 riporta per il 032C un RGB anomalo (refuso di stampa, confermato): è stato adottato lo standard Pantone 032C. Vedi _palette.scss.

Licenza

Codice sotto licenza MIT. Marchi, emblemi e palette AGESCI restano proprietà dell'Associazione e sono soggetti al regolamento associativo sull'uso del marchio.

Project details

Verified details

These details have been verified by PyPI
Project links
Owner
GitHub Statistics

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT License (MIT)
  • Author: AGESCI Campania
  • Tags agesci , bootstrap , django , scout , theme
  • Requires: Python >=3.12
  • Provides-Extra: icons
Classifiers

Release history Release notifications | RSS feed

2.2.2

2.2.1

2.2.0

2.1.0

2.0.0

1.2.4

1.2.2

This version

1.2.1

1.2.0

1.1.0

1.0.0

Download files

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

Source Distribution

django_agesci_campania_theme-1.2.1.tar.gz (1.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_agesci_campania_theme-1.2.1-py3-none-any.whl (1.5 MB view details)

Uploaded Python 3

File details

Details for the file django_agesci_campania_theme-1.2.1.tar.gz.

File metadata

  • Download URL: django_agesci_campania_theme-1.2.1.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for django_agesci_campania_theme-1.2.1.tar.gz
Algorithm Hash digest
SHA256 fb33bf1dd5755c3880a96a07fcbe47c8e819b57a9e10fa639fa7f6af888fce4f
MD5 22b3ef946d9abc94c358eb53b9e47287
BLAKE2b-256 a0b9b906b461baf0cbda99bb8aabd6fbb26ceb9b29814ae7b6491e1104ad33e5

See more details on using hashes here.

File details

Details for the file django_agesci_campania_theme-1.2.1-py3-none-any.whl.

File metadata

  • Download URL: django_agesci_campania_theme-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 1.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for django_agesci_campania_theme-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e2ed377bf87a0ab32908bd879265b119ecede429567588f0d72e92d2ccc7a256
MD5 a021a35ff322e9ce5ae28fcbec3023fa
BLAKE2b-256 e5f408c8372c4d400aaf6dc04513618ce996351047a0d6ec6b7b2740d78de19b

See more details on using hashes here.

Supported by

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