Installazione¶

Requisiti¶

Python 3.12 o superiore
Django 6.0 o superiore
Bootstrap 5.3 (caricato da CDN, non serve installarlo)

Da PyPI (consigliato)¶

Il pacchetto è pubblicato su PyPI.

uv (consigliato)

uv add django-agesci-campania-theme

pip

pip install django-agesci-campania-theme

Con il supporto icone Bootstrap¶

Il supporto a Bootstrap Icons via django-bootstrap-icons è incluso come dipendenza opzionale nell’extra [icons]:

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

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

Vedi la sezione Icone Bootstrap per la configurazione.

Da GitHub (versione di sviluppo)¶

Per installare l’ultima versione dal branch main (serie 2.x attuale):

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

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

Nota

La serie 2.x introduce breaking changes rispetto alla v1.x. Consulta la guida di migrazione prima di aggiornare da una versione 1.x.

Configurazione minima in Django¶

Dopo l’installazione aggiungi "agesci_theme" a INSTALLED_APPS e il context processor alla lista dei context_processors:

# settings.py

INSTALLED_APPS = [
    # ... app Django standard ...
    "agesci_theme",
]

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [],
        "APP_DIRS": True,
        "OPTIONS": {
            "context_processors": [
                "django.template.context_processors.debug",
                "django.template.context_processors.request",
                "django.contrib.auth.context_processors.auth",
                "django.contrib.messages.context_processors.messages",
                # --- Tema AGESCI ---
                "agesci_theme.context_processors.agesci_theme",
            ],
        },
    }
]

Assicurati che Django possa servire i file statici:

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

Il tema è ora pronto. Procedi con la Configurazione per personalizzarlo.