Tutorial GitHub

Perché questo tutorial

Al tavolo sui Beni Confiscati di #SOD14 bisognava condividere informazioni e prototipi tra i partecipanti, a loro volta divisi in sottogruppi. Si è usato Google Drive per i documenti ed i DB di partenza, ma poi serviva un sistema per prototipare il sito e condividere le modifiche. Così è nato questo repository su GitHub. Ed è anche emerso che diversi partecipanti (programmatori o meno) non avevano mai usato questo strumento. Usiamo questa pagina per inserire un po' di informazioni pratiche sull'utilizzo di GitHub.

Cos'è GitHub

In generale, Git è un sistema per gestire le modifiche al codice sorgente da parte di singoli o gruppi di lavoro anche grandi. Il software tiene traccia di ogni modifica fatta al codice permettendo di avere uno storico e di ritornare, se necessario, sui propri passi. Poi ci sono funzioni ulteriori, come ad esempio il fork che permette di prendere un repository di partenza e partire da lì per creare un software anche del tutto diverso e distinto.

Pronti a partire!

Un canovaccio da seguire per essere subito operativi con GitHub. No frills!

Windows

Riporto 3 punti per l'installazione (tradotti da qui)

1. Si scarica e si installa il client: windows.github.com
2. Quando fai partire l'app, potrai scegliere se usare un account GitHub esistente o crearne uno nuovo.
3. A sinistra trovi il tuo account GitHub, e le organizzazioni di cui fai parte. Cliccando su un nome ti mostra i repository disponibili. Cliccando su clone scarica la repository nel tuo PC.
4. Nel caso di Confiscati Bene, per prima cosa devi chiedere a qualcuno di Spaghetti Open Data di aggiungerti all'organizzazione per visualizzare le repository di SOD dal client.

A questo punto si è operativi. Una volta trovata la repository spaghetti-open-data/beni-confiscati-aperti questo va clonato. Il programma crea (di solito in Documenti/GitHub) una cartella che clona quanto è nel repository online. Nel caso di beni-confiscati-aperti bisogna aver cura, in alto a destra, di scegliere la branch giusta, ovvero attualmente si lavora su gh-pages che è la branch che permette di vedere i files all'URL pubblico: http://spaghetti-open-data.github.io/beni-confiscati-aperti/

Commit

Attenzione: da ora in poi ogni modifica che fate sui files nella cartella clonata, viene monitorata da GitHub. Se siete sicuri di aver completato una modifica ad un file, dovete mandare il commit. Per far questo ci sono 2 passaggi:

1. Sulla sinistra, in alto è indicato che ci sono delle modifiche ancora da confermare. Bisogna indicare un titolo descrittivo della modifica e una breve descrizione opzionale, e poi confermare. Ma non basta!
2. Bisogna sincronizzare col repository remoto. Questo si fa cliccando sul pulsante Sync in alto a destra. Fatto questo, tutto sarà sincronizzato e non dovrebbero più risultare modifiche uncommitted.

Se non siete sicuri di volere "scrivere" direttamente sul branch principale, createvi un vostro branch. Questo permette di fare qualunque modifica senza toccare il codice su cui stanno lavorando gli altri. Quando avete una modifica che vorreste vedere incorporata nel codice del ramo principale (detto "master"), potete fare una richiesta di pull dal sito gitbub.com. Dal punto di vista tecnico non cambia niente, ma si dà un grado di controllo in più allo sviluppatore principale del progetto.

Mac

1. Si scarica e si installa il client: mac.github.com
2. Quando lanci l'app, devi agganciarla a un account su github.com. Questo si fa cliccando su GitHub (nel menu) => Preferenze => Account.
3. A sinistra trovi il tuo account GitHub, e le organizzazioni di cui fai parte. Cliccando su un'organizzazione, la finestra principale (a sinistra) ti mostra i repository disponibili. Il tasto su Clone to computer crea un duplicato della repository in locale sul Mac.

Nel caso di beni-confiscati-aperti, procedi così:

1. Chiedi a qualcuno di SOD di aggiungerti all'organizzazione su GitHub
2. Dal client di GitHub,clicca su spaghetti-open-data
3. Localizza beni-confiscati-aperti e clicca sul tasto Clone to computer

Da questo momento in poi, GitHub tiene conto di qualunque modifica tu faccia ai files della copia locale del codice (di solito è una cartella in Users/TUONOMEUTENTE/github/local). Fai le modifiche in locale sul tuo computer, poi riapri GitHub. 4. Per prima cosa clicca sul branch su cui hai lavorato (usa l'icona "Branches" sulla sinistra). 5. Clicca sull'icona "Changes" e vedrai che GitHub ti segnala che ci sono "uncommitted changes". Devi obbligatoriamente scrivere qualche parola che descrive i cambiamenti che hai fatto, e puoi aggiungere una descrizione più dettagliata (utile se hai fatto molti cambiamenti). 6. Clicca –Commit_. 7. A questo punto, GItHub ti segnala che ci sono "unsynced commits". Clicca su Sync.

Linux

TO DO