Ottenere il blocco di GitHub

Un progetto è sempre più divertente quando hai amici che lavorano con te, ma come possono farlo quando si lavora su un progetto di codifica? Terrò la mia tastiera per me, grazie.

Inserisci GitHub. Con questo servizio web, puoi condividere i tuoi progetti di codifica e collaborare con facilità!

disconoscimento

Questo tutorial presumerà che tu abbia familiarità con Git, probabilmente il miglior software di controllo della versione distribuito che ci sia. Già perso? Non preoccuparti: leggi la mia introduzione a Git per iniziare. Quindi torna qui e scopri tutto su GitHub, il social network per sviluppatori!

Iniziare

Naturalmente, avrai bisogno di un account GitHub se vuoi sperimentare qualcuna delle qualità del codice sociale. Facciamolo adesso. Vai al sito Web GitHub e fai clic su "Prezzi e iscrizioni" in alto.

Creare un account

Esistono diversi piani che è possibile utilizzare, a seconda delle esigenze. In questo momento, l'account gratuito "open source" è tutto ciò che vogliamo; quindi facciamo clic su "Registrati". È la tua pagina di iscrizione standard; inserisci il tuo nome, indirizzo email e password. Avrai anche bisogno di una chiave pubblica SSH; Ho spiegato come ottenerne uno nel mio precedente articolo:

Apri il tuo terminale e digita questo: ssh-keygen -t rsa -C "[email protected]". L'opzione t assegna un tipo e l'opzione C aggiunge un commento, tradizionalmente il tuo indirizzo email. Ti verrà quindi chiesto dove salvare la chiave; basta premere invio per fare (che salva il file nella posizione predefinita). Quindi, inserisci una passphrase, due volte. Ora hai una chiave; Diamo a GitHub.

Per prima cosa, prendi la tua chiave dal file; il terminale ti avrà detto dove è stata memorizzata la chiave; apri il file, copia la chiave (fai attenzione a non aggiungere nessuna nuova riga o spazio bianco).

Una volta che hai la chiave, incollala nel campo corretto. Come dice, non devi farlo ora; puoi aggiungere una chiave più tardi. Quindi fare clic sul pulsante per accettare e iscriversi.

Riscaldando fino all'interfaccia

Quando accedi per la prima volta, vedrai la dashboard; è qualcosa del genere:

Nell'angolo in alto a destra, puoi vedere una barra degli strumenti con le opzioni per il controllo del tuo account. Ci sono anche alcuni link per spostarsi su GitHub, così come la casella di ricerca.

Il pannello principale offre una serie di azioni; in seguito, sarà usato per tenerti aggiornato sui progetti che ti interessano. E sulla destra di ciò, saranno elencati i tuoi repository. Ricorda, in Git, i repository sono i contenitori che contengono tutto il codice e la cronologia relativi a un progetto.
Quando ne hai la possibilità, naviga tra le Impostazioni dell'account, è tutto ciò che ti aspetti, quindi non lo esaminerò; ma se hai intenzione di essere un appassionato di githubber, dovresti probabilmente compilare il tuo profilo e vedere cos'altro c'è lì dentro.

È tutto su Repos

In realtà, l'intero scopo di GitHub è rendere i repository Git disponibili per il mondo; di conseguenza, ne consegue che lavorare con repository (o repository, come vengono spesso chiamati) è qualcosa con cui dovresti essere a tuo agio.

Creare un repository è abbastanza semplice. Nella dashboard, fai clic su "Nuovo repository" sopra l'elenco di repo (che è attualmente vuoto).

Tre caselle di testo ti aspettano qui; il tuo repository avrà bisogno di un nome di progetto, una descrizione e l'URL per il sito web del progetto. Se hai effettuato l'aggiornamento a uno dei piani a pagamento, puoi scegliere se questo deve essere disponibile al pubblico o meno. Quando hai finito, premi "Crea repository".
GitHub ora ti fornirà le istruzioni per collegare il repository GitHub a uno dei tuoi repository Git locali. Se hai familiarità con Git, questo dovrebbe essere abbastanza vecchio per te. La parte importante sono le ultime due righe di "Prossimi passi" o "Esistente Git Repo?"

 git remote add origin [email protected]: aburgess / My-First-GitHub-Repo.git git push origine master

Il comando git-remote ti consente di tracciare altri repository e mantenerli "sincronizzati" con quello locale. Nel nostro caso, stiamo monitorando il repository su GitHub dal nostro repository locale. Quindi, quella prima riga è l'aggiunta di un telecomando; lo chiamiamo "origine" e gli diamo un URL. Questo è un URL privato che solo tu puoi usare per leggere e scrivere sul tuo repository GitHub.

Nella seconda riga, stiamo usando il comando git-push per inviare tutto il ramo principale all'origine (il nostro repository GitHub). Si noti che nessuno dei lavori su codifica o progetto (creazione di file, ecc.) Viene eseguito su GitHub. Questo è tutto lavoro locale; dovresti lavorare sul tuo progetto proprio come faresti con un semplice repo locale. Tuttavia, lo invierai regolarmente a GitHub con quella seconda riga.

Quindi diciamo che hai lavorato su un progetto per un po 'e hai spinto i tuoi commit in un repository GitHub. Quali meta-dati del progetto possiamo esplorare su GitHub? Diamo un'occhiata al repository jQuery.

Vedi quella barra degli strumenti in alto, proprio sotto il nome del progetto? Queste opzioni ci permettono di approfondire alcune delle informazioni Git che abbiamo scoperto nella linea di comando l'ultima volta. Al momento, siamo nella scheda sorgente. Inizia con elenchi a discesa per i rami e le etichette pronti contro termine; usali per vedere i vari rami o tag. Ci sono anche alcuni meta-dati di progetto; abbiamo il nome del progetto, l'URL e gli URL di clonazione (questi URL sono di sola lettura).

Quindi, è possibile visualizzare le informazioni sull'ultimo commit: autore, ora, commento e hash. Sotto questo, hai un browser di file, che ti mostra le ultime versioni di tutti i file nel progetto, così come la loro età e il messaggio dell'ultimo commit sono stati modificati in.

Se il progetto ha un file leggimi, viene visualizzato sotto il browser di file.

commit

Passiamo alla scheda commit in alto e vediamo cosa contiene.

Come ci si potrebbe aspettare, possiamo visualizzare un backlog di commit su questo progetto. Facendo clic sull'hash del commit (a destra della voce di commit) potrai vedere cosa è stato cambiato nel commit.

Le linee verdi (precedute da un '+') sono aggiunte e le linee rosse (precedute da un '-') sono cancellazioni.
Puoi iscriverti al feed RSS della storia del commit di qualsiasi repository se vuoi tenerne traccia.

Rete

La prossima scheda è la scheda di rete; questo ti mostra una rappresentazione grafica della storia del repository. Questo grafico è tratto dal punto di vista del jQuery del committer. Ogni commit viene visualizzato solo una volta, quindi i commit non sulla riga di jQuery non si trovano nel repository di jQuery. In questo modo, possiamo vedere ciò che commette gli altri hanno fatto che non abbiamo. E 'incredibilmente utile, ma un po' confuso se non sei gunnito fino in fondo. Se vuoi saperne di più, controlla il post del blog di GitHub a riguardo.
La scheda di rete offre anche un elenco di membri (persone che hanno biforcato il repository) e un feed.

grafici

La scheda dei grafici ti offre una serie di diverse viste del tuo progetto da una prospettiva grafica. In realtà sono solo metadati, ma possono offrire alcuni spunti interessanti:

Coda forcelle

Se stai visualizzando un repository di tua proprietà, vedrai un'altra scheda, Coda forcelle. Questo ti mostra le stesse informazioni che hai visto nel grafico di rete, ma in modo diverso. Da qui, puoi scegliere quali commit applicare al tuo repository, su qualsiasi ramo tu voglia. Per ulteriori informazioni sulla coda delle forcelle, controlla questo post e i video sul blog di GitHub.

Puoi abilitare altre tre schede dal pannello di amministrazione del repository: Wiki, Problemi e Download. Questi ti permettono di creare un wiki, tracciare bug nel tuo progetto e offrire copie scaricabili del tuo repository. Sono tutti abbastanza intuitivi.

Il lato sociale

Come dice lo slogan, GitHub è interamente dedicato al social coding. Anche se ne abbiamo già visti alcuni, è tempo di controllare il resto delle funzionalità social di GitHub.

Esplorando altri repository

Se hai un po 'di tempo libero e vuoi scavare per un po' in un progetto di codifica, GitHub è il posto ideale dove andare. Vediamo come possiamo trovare progetti interessanti.
Inizia facendo clic su "Esplora GitHub" a destra della casella di ricerca. Abbiamo un paio di schede tra cui scegliere qui:

  • repository
  • Ricerca
  • Sequenza temporale
  • Le lingue
  • changelog

Per me, il più interessante è la scheda delle lingue; scegli la tua lingua e dai un'occhiata ai progetti più guardati e più biforcati per quella lingua.

Quindi diciamo che hai trovato un progetto a cui sei interessato; che poi??

Interagire con altri repository

Durante la visualizzazione di un repository, gli strumenti social sono sotto la barra di ricerca. Partendo a destra, puoi vedere quante persone hanno biforcato il progetto e quante persone lo stanno guardando. Abbiamo parlato di biforcazione e sorveglianza, ma è tempo di avere alcune definizioni formali sul tavolo.

  • Fare un fork di un progetto significa che otterrai una copia di quel repository che potrai giocare con tutto ciò che desideri.
  • Guardare un progetto significa che qualsiasi azione su di esso verrà visualizzata nel tuo feed di notizie, nella tua dashboard.

Sto seguendo una scia di conigli, ma puoi fare di più che guardare i progetti; se trovi sviluppatori particolarmente talentuosi, puoi seguirli per tracciare ogni loro battitura. Basta fare clic sul pulsante segui sulla loro pagina del profilo.

Puoi anche inviare loro un messaggio se lo desideri. Ora stiamo parlando di social network!

Di nuovo sulla barra degli strumenti social, il pulsante successivo (spostandosi a sinistra) consente di scaricare il codice sorgente del progetto in modo prevedibile. Il prossimo pulsante ti consente di bloccare il repository e l'ultimo ti permette di guardarlo (l'hai visto arrivare).

Se stai guardando un repository di tua proprietà, ci saranno altri due pulsanti nella riga: 'Pull Request' e 'Admin.' Torneremo a "Pull Request" tra un minuto; sentiti libero di guardarti intorno nel pannello di amministrazione.

Dovrebbe essere ovvio la maggior parte delle caratteristiche di base sono:

  • cambia il tuo ramo predefinito
  • crea una pagina di progetto (torneremo su questo)
  • attiva / disattiva le schede aggiuntive (wiki, download, problemi)
  • rinominare o eliminare il repository

Al termine, fai clic sul nome del progetto in alto per tornare alla vista di origine.

Il nostro scenario prima di introdurre gli strumenti social era che avevi trovato un repository su cui vuoi lavorare. La prima cosa da fare è sborsare il progetto; basta cliccare sul pulsante 'forchetta'. Ora hai una copia del repository nel tuo account. Cloniamo il repository sul tuo computer, usando il tuo URL clone privato. In questo modo si imposta automaticamente un'origine chiamata remota, come abbiamo discusso in precedenza. Quell'origine non è il progetto originale che hai biforcato (non puoi scrivere a questo) ma la tua copia biforcuta di esso. Tuttavia, è necessario configurare un telecomando per il progetto originale; fallo con questo comando:

 git remote add upstream [URL clone pubblico del progetto originale qui] git fetch upstream

Quest'ultima riga ottiene gli ultimi rami dal remoto upstream e li archivia nei rami di rilevamento.
Ora è il momento di iniziare a programmare. Mentre esegui commit, visualizzeranno il grafico di rete del progetto originale, perché non si trovano in quel repository. Verranno anche visualizzati nella coda delle forcelle di quel repository, quindi il proprietario può inserirli se gli / le piacciono. Tuttavia, puoi richiedere di essere richiamati. Questo è il motivo per cui è il pulsante di richiesta pull: puoi inviare al proprietario del repository originale un messaggio.

Non è niente di speciale; davvero, fa solo sapere loro che dovrebbero controllare la loro coda di forchetta.
Ma cosa succede se hanno apportato modifiche al progetto da quando lo hai forgiato? È consigliabile integrare le modifiche nel repository prima di richiedere l'inserimento delle modifiche. Puoi facilmente ottenere i loro aggiornamenti usando quel telecomando a monte che hai creato! Basta eseguire questo comando:

 git fetch upstream master git unione upstream / master

Come abbiamo appena visto, il comando fetch ottiene il contenuto più recente dal telecomando specificato, in questo caso il nostro telecomando a monte. Inoltre, stiamo specificando che vogliamo solo il ramo principale. La seconda riga unisce il ramo specificato con quello in cui ci troviamo. Siamo nel ramo principale del nostro repository locale e vogliamo unire il nostro ramo di monitoraggio upstream / master.

Nota: se questo ramo di monitoraggio ti confonde, consulta questo articolo su gitready.com. Fondamentalmente, i rami di monitoraggio sono semplicemente rami che tengono traccia di dove altri repository con lo stesso progetto sono in relazione al repository. Per vedere tutti i tuoi rami esegui il comando git branch -a. Ecco cosa posso ottenere per un repository biforcato:

Se sei pigro, puoi eseguire il comando git pull upstream master. Questo fa sia il recupero che i comandi di unione in una volta. Tuttavia, questo potrebbe causare problemi di unione, quindi stai lontano da esso!
Una volta che le modifiche sono state unite, puoi richiedere un tiro con tranquillità, sapendo che la tua forcella è aggiornata con il repository upstream.

Pagine dell'utente e del progetto

Github ti dà una possibilità piuttosto unica di creare un sito web personale da un repository GitHub. Il mio nome utente GitHub è andrew8088, quindi se avessi creato un repository denominato andrew8088.github.com, sarebbe stato pubblicato su http://andrew8088.github.com. Semplice come quella!

Puoi anche creare un sito per un progetto; questo è un po 'più complicato, ma GitHub rende facile ottenere una singola pagina generica che spiega il tuo progetto. Fai clic sul pulsante di amministrazione nella barra degli strumenti social. Quindi fare clic su "Genera la pagina del progetto" in "Informazioni sul repository".

Quindi, compila tutti i campi:

E fai clic su "Crea pagina".

Se desideri personalizzare ulteriormente la tua pagina o aggiungere pagine, puoi seguire le istruzioni avanzate alla Guida di GitHub Pages.

Quando è solo uno snippet

Hai mai parlato di codice con un amico online e hai voluto condividere uno snippet? Succede a tutti noi, e GitHub offre un modo rapido per farlo. È Gist. Lo dicono meglio:

Gist è un modo semplice per condividere frammenti e incolla con gli altri. Tutti gli elenchi sono repository git, quindi sono automaticamente versionati, forkable e utilizzabili come repository git.

Fai clic sul link Gist a sinistra della casella di ricerca o vai a Gist.GitHub.com. Puoi semplicemente incollare il tuo snippet o digitarlo tutto. Dagli un nome di file e fagli sapere quale lingua scrivi (per evidenziare la sintassi). Quindi fare clic su "Crea pubblico Gist". Copia l'URL e condividi!

Tenersi al corrente

Qualsiasi social network può diventare avvincente e GitHub non è diverso. Se vuoi tenere traccia dei tuoi repository mentre sei in movimento, consulta iOctocat, l'app GitHub per iPhone e iPod Touch.

Conclusione

Beh, è ​​stato un tour vorticoso, ma spero che tu abbia più familiarità con quello che potrebbe essere il miglior sito di hosting / condivisione del codice sul web! Hai mai usato GitHub? Hai un'opzione migliore? Colpisci i commenti!

Scrivi un tutorial Plus

Sapevi che puoi guadagnare fino a $ 600 per scrivere un tutorial PLUS e / o screencast per noi? Stiamo cercando tutorial dettagliati e ben scritti su HTML, CSS, PHP e JavaScript. Se sei dell'abilità, contatta Jeffrey a [email protected].

Si prega di notare che il risarcimento effettivo dipenderà dalla qualità del tutorial finale e screencast.

  • Seguici su Twitter o iscriviti al feed Nettuts + RSS per i migliori tutorial di sviluppo web sul web.