Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- bootstrap_bolweb:come_iniziare [2021/09/21 18:44]
admin
+++ bootstrap_bolweb:come_iniziare [2021/10/18 13:23] (versione attuale)
admin
@@ Linea 1: / Linea 1: @@
 ====== Come iniziare ======
-La libreria Bolweb è composta dalle cartelle Frontend e Webapp.
+===== Introduzione =====
-La prima contiene i file js ed scss customizzati e che differenziano Bolweb da Bootstrap Italia, nella seconda cartella invece sono contenute le dipendenze su cui Bolweb si appoggia e le risorse utili per il completamento del layout.
-Per utilizzare Bolweb bisogna inserire la cartella all'interno del proprio progetto. La libreria può essere scaricata al seguente link:
+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}}
-Si sta predisponendo anche un repository npm per poter aggiungere la libreria come dipendenza ai propri progetti. Verranno aggiunti i dettagli di configurazione appena si avranno a dispozione i riferimenti definitivi.
+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.