Differenze

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

--- bootstrap_bolweb:come_iniziare [2021/10/14 11:00]
admin
+++ bootstrap_bolweb:come_iniziare [2021/10/18 13:23] (versione attuale)
admin
@@ Linea 1: / Linea 1: @@
 ====== 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 ======
@@ Linea 19: / Linea 23: @@
 </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.