Den Hang von GitHub bekommen

Ein Projekt macht immer mehr Spaß, wenn Sie Freunde haben, die mit Ihnen arbeiten, aber wie kann es bei einem Codierungsprojekt gemacht werden? Ich werde meine Tastatur für mich behalten, danke.

Gib GitHub ein. Mit diesem Webdienst können Sie Ihre Codierungsprojekte freigeben und problemlos zusammenarbeiten!

Haftungsausschluss

In diesem Lernprogramm wird davon ausgegangen, dass Sie mit Git, der wohl besten verteilten Versionskontrollsoftware, vertraut sind. Schon verloren? Keine Sorge: Lesen Sie meine Einführung zu Git, um loszulegen. Dann komm zurück und erfahre alles über GitHub, das soziale Netzwerk für Entwickler!

Fertig machen

Natürlich benötigen Sie ein GitHub-Konto, wenn Sie die soziale Kodierung kennenlernen möchten. Lass uns das jetzt machen. Gehen Sie zur GitHub-Website und klicken Sie oben auf "Preise und Registrierung".

Ein Profil erstellen

Je nach Ihren Bedürfnissen können Sie verschiedene Pläne verwenden. Im Moment ist das kostenlose "Open Source" -Konto alles, was wir wollen; Also lass uns auf "Anmelden" klicken. Es ist Ihre Standard-Anmeldeseite. Geben Sie Ihren Namen, Ihre E-Mail-Adresse und Ihr Passwort ein. Sie benötigen auch einen öffentlichen SSH-Schlüssel. Ich habe in meinem vorherigen Artikel erklärt, wie man einen bekommt:

Öffnen Sie Ihr Terminal und geben Sie Folgendes ein: ssh-keygen -t rsa -C "[email protected]". Die Option t weist einen Typ zu und die Option C fügt einen Kommentar hinzu, normalerweise Ihre E-Mail-Adresse. Sie werden dann gefragt, wo der Schlüssel gespeichert werden soll. Drücken Sie einfach die Eingabetaste, um die Datei am Standardspeicherort zu speichern. Geben Sie dann zweimal eine Passphrase ein. Jetzt hast du einen Schlüssel. lass es uns GitHub geben.

Holen Sie sich zuerst Ihren Schlüssel aus der Datei. Das Terminal hat Ihnen mitgeteilt, wo der Schlüssel gespeichert wurde. Öffnen Sie die Datei, kopieren Sie den Schlüssel (achten Sie darauf, keine Zeilenumbrüche oder Leerzeichen hinzuzufügen)..

Sobald Sie den Schlüssel haben, fügen Sie ihn einfach in das richtige Feld ein. Wie es heißt, müssen Sie das jetzt nicht tun; Sie können später einen Schlüssel hinzufügen. Klicken Sie dann auf die Schaltfläche, um zuzustimmen und sich anzumelden.

Aufwärmen an der Schnittstelle

Wenn Sie sich zum ersten Mal anmelden, wird das Dashboard angezeigt. es ist so etwas:

In der rechten oberen Ecke sehen Sie eine Symbolleiste mit Optionen zur Steuerung Ihres Kontos. Es gibt auch einige Links, um GitHub und das Suchfeld zu umgehen.

Das Hauptfenster bietet eine Reihe von Aktionen. Später wird es verwendet, um Sie über die Projekte, an denen Sie interessiert sind, auf dem Laufenden zu halten. Rechts davon werden Ihre eigenen Repositorys aufgelistet. Denken Sie daran, dass in Git Repositorys die Container sind, die den gesamten Code und Verlauf eines Projekts enthalten.
Wenn Sie eine Chance haben, stöbern Sie in den Kontoeinstellungen. Es ist alles, was Sie erwarten würden, damit ich es nicht besuche. Wenn Sie jedoch ein begeisterter Githubber sein möchten, sollten Sie wahrscheinlich Ihr Profil ausfüllen und sehen, was sonst noch da ist.

Es geht nur um Repos

Der ganze Zweck von GitHub besteht darin, Git-Repositories der Welt zur Verfügung zu stellen. Daraus folgt, dass die Arbeit mit Repositories (oder Repos, wie sie oft genannt werden) etwas ist, mit dem Sie sich wohl fühlen sollten.

Ein Repository zu erstellen ist ziemlich einfach. Klicken Sie im Dashboard auf "Neues Repository" oberhalb Ihrer Repo-Liste (die derzeit leer ist)..

Drei Textfelder erwarten Sie hier. Ihr Repository benötigt einen Projektnamen, eine Beschreibung und die URL für die Website des Projekts. Wenn Sie ein Upgrade auf eines der bezahlten Pakete durchgeführt haben, können Sie wählen, ob dieses für die Öffentlichkeit verfügbar sein soll oder nicht. Wenn Sie fertig sind, klicken Sie auf "Repository erstellen".
GitHub gibt Ihnen nun Anweisungen, wie Sie das GitHub-Repository mit einem Ihrer lokalen Git-Repositorys verknüpfen können. Wenn Sie mit Git vertraut sind, sollte dies für Sie ziemlich alt sein. Der wichtige Teil sind die letzten beiden Zeilen der "Next Steps" oder "Existing Git Repo?"

 git remote hinzufügen origin [email protected]: aburgess / My-First-GitHub-Repo.git git push origin master

Mit dem Befehl git-remote können Sie andere Repositorys verfolgen und mit Ihrem lokalen "synchronisiert" halten. In unserem Fall verfolgen wir das Repository auf GitHub von unserem lokalen Repository aus. In dieser ersten Zeile wird also eine Fernbedienung hinzugefügt. wir nennen es "origin" und geben ihm eine URL. Dies ist eine private URL, die nur Sie zum Lesen und Schreiben Ihres GitHub-Repos verwenden können.

In der zweiten Zeile verwenden wir den Befehl git-push, um alles im Master-Zweig zum Ursprung (unserem GitHub-Repository) zu senden. Beachten Sie, dass keine der Codierungs- oder Projektarbeiten (Erstellen von Dateien usw.) auf GitHub ausgeführt werden. Das ist alles lokale Arbeit; Sie sollten an Ihrem Projekt genauso arbeiten wie an einem einfachen lokalen Repo. Sie werden es jedoch regelmäßig mit dieser zweiten Zeile an GitHub senden.

Nehmen wir also an, Sie haben eine Zeitlang an einem Projekt gearbeitet und Ihre Verpflichtungen zu einem GitHub-Repo verschoben. Welche Projekt-Metadaten können wir auf GitHub untersuchen? Schauen wir uns das jQuery-Repository an.

Sehen Sie die Symbolleiste oben unter dem Projektnamen? Mit diesen Optionen können wir einige der Git-Informationen untersuchen, die wir zuletzt in der Befehlszeile gefunden haben. Im Moment befinden wir uns auf der Registerkarte "Quelle". Es beginnt mit Dropdown-Listen für die Repo-Zweige und -Tags. Verwenden Sie diese, um die verschiedenen Zweige oder Tags anzuzeigen. Es gibt auch einige Projekt-Metadaten. Wir haben den Projektnamen, die URL und die Klon-URLs (diese URLs sind schreibgeschützt)..

Anschließend können Sie die Informationen zum neuesten Commit anzeigen: Autor, Zeit, Kommentar und Hashes. Darunter befindet sich ein Dateibrowser, der Ihnen die neuesten Versionen aller Dateien im Projekt sowie deren Alter und die Nachricht des letzten Commit anzeigt, in dem sie geändert wurden.

Wenn das Projekt über eine Readme-Datei verfügt, wird diese unter dem Dateibrowser angezeigt.

Commits

Wechseln wir oben zur Commits-Registerkarte und sehen Sie, was darin enthalten ist.

Wie Sie vielleicht erwarten, können wir einen Rückstand bei den Commits für dieses Projekt sehen. Durch Klicken auf den Commit-Hash (rechts neben dem Commit-Eintrag) können Sie sehen, was sich im Commit geändert hat.

Grüne Linien (vorangestellt mit einem '+') sind Ergänzungen und rote Linien (vorangestellt mit einem '-') sind Löschungen.
Sie können den RSS-Feed zum Commit-Verlauf jedes Repos abonnieren, wenn Sie den Überblick behalten möchten.

Netzwerk

Die nächste Registerkarte ist die Netzwerkregisterkarte. Dies zeigt Ihnen eine grafische Darstellung der Historie des Repositorys. Dieses Diagramm wurde aus der Perspektive des Committers 'Jquery' gezeichnet. Jedes Commit wird nur einmal angezeigt. Commits, die nicht in der Zeile von jQuery sind, sind nicht im Repo von jQuery enthalten. Auf diese Weise können wir sehen, was andere Leute gemacht haben, was wir nicht haben. Es ist unglaublich nützlich, aber etwas verwirrend, wenn man nicht den ganzen Weg grokking ist. Wenn Sie mehr darüber erfahren möchten, lesen Sie den Blog-Beitrag von GitHub darüber.
Auf der Registerkarte "Netzwerk" finden Sie auch eine Liste der Mitglieder (Personen, die das Repo erstellt haben) und einen Feed.

Diagramme

Die Registerkarte "Diagramme" bietet Ihnen eine Reihe verschiedener Ansichten Ihres Projekts aus grafischer Sicht. Es sind wirklich nur Metadaten, aber es kann einige interessante Einblicke geben:

Gabel-Warteschlange

Wenn Sie ein eigenes Repository anzeigen, wird eine weitere Registerkarte angezeigt, die Fork-Warteschlange. Dies zeigt Ihnen die gleichen Informationen, die Sie in der Netzwerkgrafik gesehen haben, jedoch unterschiedlich. Hier können Sie auswählen, welche Commits für Ihr Repository gelten sollen, für welchen Zweig Sie auch möchten. Weitere Informationen zur Fork-Warteschlange finden Sie in diesem Beitrag und im Video im GitHub-Blog.

Sie können drei weitere Registerkarten im Repo-Admin-Fenster aktivieren: Wiki, Probleme und Downloads. Damit können Sie ein Wiki erstellen, Fehler in Ihrem Projekt nachverfolgen und herunterladbare Kopien Ihres Repos anbieten. Sie sind alle ziemlich intuitiv.

Die soziale Seite

Wie der Slogan sagt, dreht sich bei GitHub alles um soziale Kodierung. Obwohl wir bereits einige von ihnen gesehen haben, ist es an der Zeit, sich mit den übrigen sozialen Funktionen von GitHub vertraut zu machen.

Erkundung anderer Repositories

Wenn Sie jemals etwas Freizeit haben und sich für eine Weile in ein Codierungsprojekt einarbeiten möchten, ist GitHub der ideale Ort für Sie. Mal sehen, wie wir interessante Projekte finden können.
Klicken Sie zunächst auf "Explore GitHub" rechts neben dem Suchfeld. Wir haben hier ein paar Registerkarten zur Auswahl:

  • Repositories
  • Suche
  • Zeitleiste
  • Sprachen
  • Änderungsprotokoll

Am meisten interessiert mich die Registerkarte Sprachen. Wählen Sie Ihre Sprache und schauen Sie sich die meistgesehenen und am meisten verzweigten Projekte für diese Sprache an.

Nehmen wir an, Sie haben ein Projekt gefunden, an dem Sie interessiert sind. was als nächstes?

Interaktion mit anderen Repositories

Beim Anzeigen eines Repos befinden sich die sozialen Tools unterhalb der Suchleiste. Wenn Sie rechts beginnen, können Sie sehen, wie viele Personen das Projekt gegabelt haben und wie viele Personen es beobachten. Wir haben über Fischen und Zuschauen gesprochen, aber es ist Zeit, einige formale Definitionen auf den Tisch zu bringen.

  • Wenn Sie ein Projekt erstellen, erhalten Sie eine Kopie dieses Repositorys, mit der Sie mit allem spielen können, was Sie möchten.
  • Wenn Sie sich ein Projekt ansehen, werden alle darauf befindlichen Aktionen in Ihrem News-Feed, in Ihrem Dashboard angezeigt.

Ich gehe einen Hasenpfad, aber Sie können mehr als nur Projekte beobachten. Wenn Sie besonders talentierte Entwickler finden, können Sie ihnen folgen, um jeden Tastendruck zu verfolgen. Klicken Sie einfach auf die Schaltfläche "Folgen" auf ihrer Profilseite.

Sie können ihnen auch eine Nachricht senden, wenn Sie möchten. Jetzt reden wir über soziales Netzwerk!

Zurück auf der sozialen Symbolleiste können Sie mit der nächsten Schaltfläche (nach links verschieben) den Quellcode des Projekts vorhersagbar herunterladen. Mit dem nächsten Button können Sie das Repo abspalten, und mit dem letzten können Sie es beobachten (Sie haben gesehen, wie es kommt)..

Wenn Sie sich ein eigenes Repository anschauen, werden in der Zeile zwei weitere Schaltflächen angezeigt: "Pull Request" und "Admin". Wir kommen in einer Minute auf "Pull Request" zurück; Schauen Sie sich im Admin-Panel um.

Es sollte offensichtlich sein, dass die meisten Grundfunktionen:

  • Ändern Sie Ihren Standardzweig
  • eine Projektseite erstellen (wir kommen darauf zurück)
  • Schalten Sie diese zusätzlichen Registerkarten (Wiki, Downloads, Ausgaben) ein bzw. aus
  • das Repo umbenennen oder löschen

Wenn Sie fertig sind, klicken Sie oben auf Ihren Projektnamen, um zur Quellansicht zurückzukehren.

Unser Szenario vor der Einführung der Sozialwerkzeuge war, dass Sie ein Repo gefunden haben, an dem Sie arbeiten möchten. Das erste, was Sie tun müssen, ist das Projekt zu formen; Klicken Sie einfach auf die Schaltfläche "Gabel". Jetzt haben Sie eine Kopie des Repos in Ihrem Konto. Lassen Sie uns das Repo mithilfe Ihrer privaten Klon-URL auf Ihrem Computer klonen. Auf diese Weise wird automatisch eine entfernte Quelle mit dem Namen urheberrechtlich eingerichtet. Dieser Ursprung ist nicht das ursprüngliche Projekt, das Sie gegabelt haben (Sie können nicht darauf schreiben), sondern Ihre gegabelte Kopie davon. Sie müssen jedoch eine Fernbedienung für das Originalprojekt einrichten. mach das mit diesem Befehl:

 git remote add upstream [Öffentliche Klon-URL des Originalprojekts hier] git Fetch Upstream

Diese letzte Zeile holt die neuesten Filialen von der Upstream-Fernbedienung und speichert sie in Tracking-Filialen.
Jetzt ist es Zeit, mit dem Programmieren zu beginnen. Beim Festschreiben zeigen sie das Netzwerkdiagramm des ursprünglichen Projekts an, da sie nicht in diesem Repo enthalten sind. Sie werden auch in der Warteschlange des Repos angezeigt, so dass der Besitzer sie einladen kann, wenn er / sie möchte. Sie können jedoch verlangen, dass sie eingezogen werden. Dafür gibt es die Pull-Request-Schaltfläche: Sie können dem Eigentümer des Original-Repos eine Nachricht senden.

Es ist nichts Besonderes. es lässt sie nur wissen, dass sie ihre Gabelwarteschlange überprüfen sollten.
Aber was ist, wenn sie an dem Projekt Änderungen vorgenommen haben, seit Sie es gegabelt haben? Es ist empfehlenswert, ihre Änderungen in Ihr Repo zu integrieren, bevor Sie aufgefordert werden, sie in Ihre Änderungen zu übernehmen. Sie können ihre Updates ganz einfach mit der von Ihnen erstellten Upstream-Fernbedienung abrufen! Führen Sie einfach diesen Befehl aus:

 git holt Upstream Master git Merge Upstream / Master zusammenführen

Wie wir gerade gesehen haben, erhält der Abrufbefehl den neuesten Inhalt von der angegebenen Fernbedienung, in diesem Fall unsere Upstream-Fernbedienung. Außerdem geben wir an, dass wir nur den Hauptzweig wollen. Die zweite Zeile verbindet den angegebenen Zweig mit dem Zweig, in dem wir uns befinden. Wir sind im Master-Zweig unseres lokalen Repos und möchten unseren Tracking-Zweig Upstream / Master zusammenführen.

Hinweis: Wenn Sie von diesem Tracking-Zweiggespräch verwirrt werden, lesen Sie diesen Artikel auf gitready.com. Tracking-Zweige sind im Grunde nur Zweige, die verfolgen, wo sich andere Repos mit demselben Projekt in Bezug auf Ihr Repo befinden. Führen Sie den Befehl aus, um alle Ihre Zweige anzuzeigen Git-Zweig -a. Folgendes bekomme ich für ein gegabeltes Repo:

Wenn Sie faul sind, können Sie den Befehl ausführen git pull upstream master. Dadurch werden sowohl die Abruf- als auch die Zusammenführungsbefehle gleichzeitig ausgeführt. Dies kann jedoch zu Zusammenführungsproblemen führen. Bleiben Sie also davon fern!
Sobald Sie die Änderungen zusammengeführt haben, können Sie in aller Ruhe einen Pull anfordern, wenn Sie wissen, dass Ihre Abzweigung mit dem Upstream-Repository auf dem neuesten Stand ist.

Benutzer- und Projektseiten

Github bietet Ihnen die einzigartige Möglichkeit, eine persönliche Website aus einem GitHub-Repository zu erstellen. Mein GitHub-Benutzername ist andrew8088. Wenn ich ein Repo mit dem Namen andrew8088.github.com erstellt habe, würde es unter http://andrew8088.github.com veröffentlicht. So einfach ist das!

Sie können auch eine Site für ein Projekt erstellen. Dies ist etwas komplizierter, aber GitHub macht es leicht, eine generische, einzige Seite zu erhalten, die Ihr Projekt erklärt. Klicken Sie auf diese Admin-Schaltfläche in Ihrer sozialen Symbolleiste. Klicken Sie dann unter "Repository-Informationen" auf "Projektseite generieren".

Dann füllen Sie einfach alle Felder aus:

Und klicken Sie auf "Seite erstellen".

Wenn Sie Ihre Seite weiter anpassen oder Seiten hinzufügen möchten, folgen Sie den erweiterten Anweisungen in der GitHub Pages-Hilfe.

Wenn es nur ein Ausschnitt ist

Haben Sie schon einmal mit einem Freund online über Code gesprochen und wollten ein Snippet teilen? Es passiert uns allen und GitHub bietet eine schnelle Möglichkeit, dies zu tun. Es ist Gist. Sie sagen es am besten:

Gist ist eine einfache Möglichkeit, Schnipsel und Pasten mit anderen zu teilen. Alle Gists sind Git-Repositories, daher sind sie automatisch versioniert, gabelbar und als Git-Repository verwendbar.

Klicken Sie auf den Link "Gist" links neben dem Suchfeld oder wechseln Sie zu Gist.GitHub.com. Sie können einfach Ihr Snippet einfügen oder alles eingeben. Geben Sie ihm einen Dateinamen und teilen Sie ihm mit, in welcher Sprache Sie schreiben (zur Syntaxhervorhebung). Klicken Sie anschließend auf "Create Public Gist". Kopieren Sie die URL und teilen Sie sie!

Im Wissen bleiben

Jedes soziale Netzwerk kann süchtig machen, und GitHub unterscheidet sich nicht. Wenn Sie Ihre Repos unterwegs verfolgen möchten, besuchen Sie iOctocat, die GitHub-App für iPhone und iPod Touch.

Fazit

Nun, es war eine Wirbelwind-Tour, aber ich hoffe, Sie fühlen sich mit der besten Website für das Hosten / Teilen von Code im Web besser vertraut! Schon mal GitHub benutzt? Habe eine bessere Wahl? Treffen Sie die Kommentare!

Schreibe ein Plus-Tutorial

Wussten Sie, dass Sie bis zu 600 US-Dollar verdienen können, wenn Sie ein PLUS-Tutorial und / oder einen Screencast für uns schreiben? Wir suchen ausführliche und gut geschriebene Tutorials zu HTML, CSS, PHP und JavaScript. Wenn Sie die Möglichkeit haben, wenden Sie sich bitte an Jeffrey unter [email protected].

Bitte beachten Sie, dass die tatsächliche Kompensation von der Qualität des abschließenden Tutorials und des Screencasts abhängt.

  • Folgen Sie uns auf Twitter oder abonnieren Sie den Nettuts + RSS-Feed für die besten Webentwicklungs-Tutorials im Web.