-
Notifications
You must be signed in to change notification settings - Fork 11
010 Creare una copia locale del sito
Questa breve guida ti spiegherà come creare sul tuo computer una copia di TerremotoCentroItalia.info. In questo modo le modifiche al codice saranno immediatamente visibili nella tua copia locale, e potrai testare tutti i miglioramenti che stai progettando. Cominciamo!
Dovrai installare sul tuo computer alcuni software per lo sviluppo. Nelle pagine linkate trovi tutte le istruzioni in dettaglio.
Per gli step successivi è richiesto un minimo di dimestichezza con il terminale a riga di comando. Niente di speciale, è uno strumento che ci consente di dare comandi al computer sotto forma di testo invece che cliccando con un mouse in una finestra. Gli utenti Mac e Linux dovrebbero avere già l'applicazione Terminale installata; per gli utenti Windows l'installazione di git include già un terminale simile a quello di Linux.
Glisseremo anche su molti dettagli di git e Github, rimandandovi all'altra guida presente nella nostra wiki.
I comandi da inserire nel terminale (anche copia-incollando) saranno indicati in questo modo: comando di esempio
Per prima cosa verifichiamo di avere installato bundler, che a sua volta ci aiuterà a installare tutte le dipendenze che ci servono: gem install bundler
Facciamo su github il fork del repository di TerremotoCentroItalia.info, poi cloniamo il nostro fork in locale: git clone https://github.com/nomeutente/terremotocentro.git (ricordati di sostituire il tuo vero nome utente)
Portiamoci all'interno della nuova cartella: cd terremotocentro
Installiamo tutte le dipendenze del progetto: bundle install
Eseguiamo, sempre nella cartella terremotocentro, bundle exec jekyll serve
Il programma stamperà a video l'indirizzo da aprire nel browser, che sarà del tipo http://127.0.0.1:4000/.
Ecco fatto, tutto qui! Buon lavoro 💪
Se si sono installate le dipendenze del progetto in ./vendor invece che a livello globale (evitando di usare sudo quindi),
nella directory ./vendor saranno presenti dei test di jekyll che pero' non saranno eseguiti correttamente,
per risolvere e' necessario aggiungere
exclude: [vendor]
alla fine del file _config.yml
Se fate girare il sito su una macchina con Linux e sviluppate sotto Windows dovrete aggiungere la riga
host: 0.0.0.0
alla fine del file _config.yml. in questo modo potrete aprire il sito da qualsiasi postazione connessa alla vostra rete e non solo dal localhost. Utile per testare le modifiche con cellulari, tablet o altri browser