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
Owner

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT)
  • Author: AGESCI Campania
  • Tags agesci , bootstrap , django , scout , theme
  • Requires: Python >=3.12
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 e footer 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 si installa direttamente da GitHub.

Con uv (consigliato)

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

Con pip

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

title, extra_head, navbar, brand_url, brand_text, nav_items, main_class, messages, content, footer, footer_text, footer_links, extra_js.

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-*.

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
Owner

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT)
  • Author: AGESCI Campania
  • Tags agesci , bootstrap , django , scout , theme
  • Requires: Python >=3.12
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

1.2.1

1.2.0

1.1.0

This version

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for django_agesci_campania_theme-1.0.0.tar.gz
Algorithm Hash digest
SHA256 4f99681fbc56f6912dd0bfd723eb28ad2272150ee2be6a75913bc08c1bb49337
MD5 33e7d3f019ca450378514934c12bfc47
BLAKE2b-256 fd2237f8a059147e871e8979e49952b7134bb6af045e6786101526c0eca4b7dd

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for django_agesci_campania_theme-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9c247c883534c58f5e18516ee53ffe875cc59dc98c2dc1b4bfb304084add1573
MD5 556c5aad9080bc4de892ce19f4ab1b7e
BLAKE2b-256 dc29f2327ed02e4d1bf478dd2fdb0973e8352f53844e0058400f85b4ac0a9a3e

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