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

This version

1.2.2

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.2.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.2-py3-none-any.whl (1.5 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: django_agesci_campania_theme-1.2.2.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.2.tar.gz
Algorithm Hash digest
SHA256 182d8e3ea67eb7914397970e6d0c9e506ea6e4152b66521e8ca0fc524639cd4b
MD5 c16fb839139c25b6f08b64e361289b12
BLAKE2b-256 6dd8830e7822ec4c8d5111beeb08c37e417a2b9fb830f1b5100cc1544cb3ef59

See more details on using hashes here.

File details

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

File metadata

  • Download URL: django_agesci_campania_theme-1.2.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 39cb30c2950b3204d9c7e55da0c24bb2ccf282b99e85189752e4a9cd25278e6f
MD5 1c7187b6f2ecc69a0b39003d46b4f3af
BLAKE2b-256 34d2eac3dbc87efe7dbf2b55934118af5f7af17928fe28d3295bf06b59b841b5

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