La libreria Bolweb è una customizzazione della libreria Bootstrap Italia, un’altra libreria costruita sulle fondamenta di Bootstrap 4.5.0, di cui eredita tutte le funzionalità, componenti, griglie e classi di utilità, personalizzandole secondo le Linee Guida di Design per i siti web della Pubblica Amministrazione, la sua struttura è composta da una cartella 'Frontend' (in cui sono presenti i file scss e js con cui si personalizza la bootstrap-italia) e 'Webapp' contenente file statici e vendors. La libreria può essere importata ed usata facilmente all'interno di framework che non si occupano direttamente della manipolazione del DOM ma si affidano a tecnologie tipo JQuery per questo tipo di interventi. La documentazione di Bootstrap Italia a cui fare riferimento in caso di un uso JQuery based, si trova al seguente indirizzo https://italia.github.io/bootstrap-italia/. La libreria 'standard' può essere scaricata al seguente link:
Invece per i progetti Angular, bisogna solo seguire i passi indicati nel paragrafo successivo.
La libreria da utilizzare nei progetti Angular può essere scaricata da npm ma richiede prima un passaggio di configurazione del registro npm da effettuare una tantum. Da linea di comando bisogna eseguire le seguenti istruzioni (testa sia su shell linux che su command line windows):
npm config set @bol:registry https://repo.exabit.it/repository/bolweb-ui/ npm config set registry https://registry.npmjs.org/
E' possibile verificare se la configurazione è andata a buon fine inserendo il seguente comando:
npm config list
Nella lista visualizzata dovrebbero essere presenti i due registri precedentemente configurati.
Se si parte dall'ultima versione del progetto archetipo, la dipendenza è già configurata all'interno del file package.json per cui basta posizionarsi nella cartella di progetto e lanciare il comando
npm install
Verranno scaricate così tutte le dipendenze configurate per il progetto base. Per qualsiasi altro progetto legato alla tecnologia angular è possibile scaricare la dipendenza eseguendo il comando:
npm install @bol/bolweb@1.0.0
La libreria subirà degli aggiornamenti per cui verranno di volta in volta riferite le versioni e le istruzioni per importare a dipendenza. Gli aggiornamenti verrano descritti su questo wiki nella pagina 'Versioni', riportando il numero di versione, la data dell'aggiornamento ed una breve descrizione dell'intervento effettuato.
In caso di problemi con la configurazione del repository, è possibile aggiungere i registri a mano nel file di configurazione di npm. Quindi, per procedere bisogna accedere alla cartella home dell'utente corrente, qui sarà presente il file .npmrc, aprire con un editor ed incollare la seguente configurazione:
@bol:registry=https://repo.exabit.it/repository/bolweb-ui/ registry=https://registry.npmjs.org/
Salvare il file e riprovare il comando di install sul progetto.