README

Skenografia è un sub-theme drupal, basato su bootstrap_italia, progettato per implementare il design delle scuole.

Architettura dei contenuti

Skenografia rappresenta il frontend dell'architettura dei contenuti delle scuole v1 mentre il backend è gestito dal modulo ouitoulia/themethla.

Interfaccia Utente (UI)

L'interfaccia grafica è basata sui I template HTML sviluppati da Designer Italia.

Skenografia aggiorna i Template HTML dalla versione 1.6 di Bootstrap Italia alla versione 2, rendendo il tema compatibile con Bootstrap 5.2.

Componenti

Rispetto al repository Design scuola pagine statiche il tema usa componenti - menu, card, header, footer, ecc. - conformi a al posto di bootstrap-italia:1.6.

Librerie CSS/JS

Rispetto al repository Design scuola pagine statiche gli stili CSS e i componenti JavaScript sono stati riscritti per essere conformi a al posto di bootstrap-italia:1.6.

La differenza più rilevante rispetto agli assets pubblicati nel repo Design scuola pagine statiche, oltre alla compatibilità alla versione 2 di bootstrap-italia, riguarda il design del software. Dal punto di vista del design, è stato abbandonato l'approccio della sovrascrittura degli stili (noto come "override" e/o "on top") in favore di un'implementazione più efficiente e scalabile. Skenografia adotta un sistema di build dinamico, il processo di sviluppo si basa sulla modifica delle variabili di bootstrap-italia per poi compilare la variante di bootstrap-italia con il design delle scuole. Questo approccio non solo migliora le prestazioni, ma anche la manutenibilità del codice, consentendo al progetto un'espansione più fluida, gestibile e riusabile.

Distribuzione

I sorgenti SCSS e JavaScript vengono caricati automaticamente su npm per agevolare il riutilizzo e la personalizzazione da parte degli sviluppatori. Inoltre attraverso l'uso delle GitHub Actions, le librerie vengono automaticamente compilate e distribuite su diverse CDN in modo che siano già pronte per la produzione.

• https://github.com/ouitoulia/skenografia/releases/latest (build produzione e sorgenti tema)
• https://www.npmjs.com/package/@ouitoulia/skenografia (sorgenti scss e js)
• https://www.jsdelivr.com/package/npm/@ouitoulia/skenografia (build produzione)
• https://classic.yarnpkg.com/en/package/@ouitoulia/skenografia (build produzione)
• https://unpkg.com/browse/@ouitoulia/skenografia@2.5.0/ (sorgenti scss e js e build produzione)

Issue

Le issue vengono gestite nel repository principale del progetto: https://github.com/ouitoulia/diagraphe/issues

Contributori, dipendenze e altre informazioni

Per contribuire al progetto effettua un Fork, aggiungi le tue modifiche e poi fai una Pull Request.

• Contributori di Skenografia
• Elenco delle dipendenze di Skenografia

Licenze software dei componenti di terze parti

Componenti distribuiti con Skenografia

Vengono di seguito elencate le licenze dei componenti distribuiti (fonte: package.json/dependencies)

• Bootstrap Italia 2 © Agenzia per l'Italia Digitale, licenza BSD-3-Clause
• Design scuole pagine statiche © Agenzia per l'Italia Digitale, licenza BSD-3-Clause
• Hamburgers © Jonathan Suh, licenza MIT

Principali dipendenze per la fase di compilazione e sviluppo

Vengono di seguito elencate le licenze dei componenti usati per lo sviluppo (fonte: package.json/devDependencies)

• clean-webpack-plugin © PonteLabs, licenza MIT
• copy-webpack-plugin © webpack-contrib, licenza MIT
• cross-env © Kent C. Dodds, licenza MIT
• css-loader © webpack-contrib, licenza MIT
• css-minimizer-webpack-plugin © webpack-contrib, licenza MIT
• mini-css-extract-plugin © webpack-contrib, licenza MIT
• postcss-loader © webpack-contrib, licenza MIT
• sass © sass, licenza MIT
• sass-loader © webpack-contrib, licenza MIT
• semver © npm, licenza ISC
• style-loader © webpack-contrib, licenza MIT
• svg-chunk-webpack-plugin © karify, licenza MIT
• svgo-loader © epegzz, licenza MIT
• terser-webpack-plugin © webpack-contrib, licenza MIT
• webpack © webpack, licenza MIT
• webpack-cli © webpack, licenza MIT
• webpack-dev-server © webpack, licenza MIT
• webpack-merge © sounisi5011, licenza MIT

License

Copyright (C) 2023/2024 https://github.com/ouitoulia

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Questo è un software libero: puoi ridistribuirlo e/o modificarlo secondo i termini della GNU General Public License versione 3 pubblicata dalla Free Software Foundation.

Questo programma è distribuito nella speranza che possa essere utile, ma SENZA ALCUNA GARANZIA; senza nemmeno la garanzia implicita di COMMERCIABILITÀ o IDONEITÀ PER UNO SCOPO PARTICOLARE. Vedere la GNU General Public License per maggiori dettagli.

Questo software è distribuito sotto i termini della GNU Affero General Public License versione 3 (AGPL-3.0)