bootstrap_bolweb:come_iniziare [Documentazione Applicativi]

Questa pagina è in sola lettura. Puoi visualizzare il sorgente, ma non puoi modificarlo. Contatta l'amministratore se pensi che ci sia un errore.
====== Come iniziare ======
===== Introduzione =====

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:

{{ :bootstrap_bolweb:bolweb.zip | Scarica Bootstrap Bolweb}}

Invece per i progetti **Angular**, bisogna solo seguire i passi indicati nel paragrafo successivo.

====== Libreria da utilizzare nei progetti Angular ======
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):

<code>
npm config set @bol:registry https://repo.exabit.it/repository/bolweb-ui/
npm config set registry https://registry.npmjs.org/
</code>

E' possibile verificare se la configurazione è andata a buon fine inserendo il seguente comando:

<code>
npm config list
</code>
    
Nella lista visualizzata dovrebbero essere presenti i due registri precedentemente configurati.
===== Installazione della dipendenza bolweb =====
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

<code>
npm install
</code>

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:
<code>
npm install @bol/bolweb@1.0.0
</code>
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 [[bootstrap_bolweb:versioni|'Versioni']], riportando il numero di versione, la data dell'aggiornamento ed una breve descrizione dell'intervento effettuato.
==== Nota ====

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:
<code>
@bol:registry=https://repo.exabit.it/repository/bolweb-ui/
registry=https://registry.npmjs.org/
</code>
Salvare il file e riprovare il comando di install sul progetto.