interessant

Wie zum Teufel benutze ich GitHub?

Sehr geehrte Goldavelez.com,

Ich habe das Programmieren gelernt und möchte GitHub zum Verwalten meiner Projekte verwenden. Trotz der Einführungsstunde, die sie geben, verstehe ich immer noch nicht, wie es überhaupt funktioniert. Kannst du mir helfen?

Mit freundlichen Grüßen,

Git-Hilfe

Lieber GH,

GitHub ist ein großartiges Tool, aber es ist definitiv ein wenig verwirrend beim ersten Mal (und möglicherweise ein paar Mal danach). Das ist wahrscheinlich der Grund, warum GitHub Software (für OS X und Windows) erstellt hat, um den Vorgang etwas zu vereinfachen. Trotzdem ist es gut, altmodisch zu lernen, da sonst Ihre Optionen in der vereinfachten Software keinen Sinn ergeben. Beginnen wir mit den Grundlagen.

Erster Schritt: Melden Sie sich bei GitHub an

Hier kommt der einfache Teil: Erstelle dir einen GitHub-Account, der sich auf der Startseite anmeldet. Nach dem Ausfüllen des Formulars meldet sich GitHub bei Ihnen an und bringt Sie zu Ihrem leeren Newsfeed. In der Mitte der Seite sehen Sie das Bootcamp (rechts abgebildet). Wir werden es durchgehen, um Ihr Konto einzurichten und später Ihr erstes Repository zu erstellen. Klicken Sie auf "Git einrichten", um zu beginnen.

Schritt Zwei: Installieren Sie Git

GitHub existiert aufgrund einer Versionskontrollanwendung namens git . Die Seite basiert auf der Funktionsweise von git und git ist ziemlich alt. Es läuft über die Kommandozeile und hat keine ausgefallene grafische Benutzeroberfläche. Da es zum Verwalten von geschriebenem Code gemacht ist, sollte dies nicht zu beängstigend klingen. (Natürlich hat GitHub, wie bereits erwähnt, eine wundervolle Software entwickelt, mit der Sie ihren Dienst ohne die Befehlszeile nutzen können, aber das wird Ihnen nicht allzu viel helfen, wenn Sie nicht die Grundlagen kennen.)

Git liest ein lokales Code-Repository (nur einen Ordner, der Code für Ihr Projekt enthält) auf Ihrem Computer und spiegelt diesen Code an einer anderen Stelle (in diesem Fall auf den Servern von GitHub). Zunächst werden wir Ihr gesamtes lokales Repository an GitHub übergeben (dh senden), aber das ist nur eine einmalige Angelegenheit. Während Sie weiter an Ihrem Code arbeiten, übernehmen Sie einfach die Änderungen. GitHub zeichnet dann die von Ihnen vorgenommenen Änderungen auf und erstellt verschiedene Versionen von Dateien, sodass Sie bei Bedarf auf alte zurückgreifen können (oder diese Änderungen einfach aus anderen Gründen nachverfolgen können). Dies ist in erster Linie der Grund, warum Sie ein Versionskontrollsystem wie git selbst verwenden möchten. Zusätzliche Vorteile ergeben sich jedoch, wenn Sie git zum Verwalten von Code mit anderen Personen verwenden, die an Ihrem Projekt arbeiten. Wenn mehrere Entwickler Code mit git festschreiben, wird GitHub zu einem zentralen Repository, in dem der gesamte Code, an dem alle arbeiten, synchron bleiben kann. Sie übernehmen Ihre Änderungen und andere Entwickler übernehmen sie (dh synchronisieren sie mit ihrem lokalen Repository). Sie werden das gleiche mit ihrem Code tun.

Git macht das alles möglich, also musst du die neueste Version herunterladen und installieren. Unter OS X installieren Sie einfach die Befehlszeilen-App. Unter Windows erhalten Sie einige weitere Elemente. Wir werden im nächsten Schritt besprechen, wie sie funktionieren.

Schritt drei: Git einrichten

Um git einzurichten, müssen Sie sich in die Befehlszeile begeben. Unter OS X bedeutet dies, dass Sie die Terminal-App starten (Festplatte -> Anwendungen -> Dienstprogramme -> Terminal). Unter Windows bedeutet dies, dass Sie die gerade installierte Git Bash-App starten - die Windows-Eingabeaufforderung. Wenn Sie fertig sind, sagen Sie git Ihren Namen wie folgt:

git config --global user.name "Your Name Here"

Zum Beispiel würde meine so aussehen, weil ich für dieses Beispiel einen Testaccount verwende:

git config --global user.name "Adam Dachis"

Sie können einen beliebigen Namen eingeben, aber danach müssen Sie Ihre E-Mail-Adresse eingeben. Diese E-Mail-Adresse ist die E-Mail-Adresse, die Sie bei der Anmeldung bei GitHub verwendet haben:

git config --global user.email " "

Wenn Sie sich aus irgendeinem Grund mit einer falschen E-Mail-Adresse bei GitHub angemeldet haben, müssen Sie diese ändern.

Um zu vermeiden, dass Sie immer Ihre Anmeldeinformationen eingeben und SSH-Schlüssel generieren, sollten Sie den Helper für Anmeldeinformationen installieren, damit Ihre Kennwörter zwischengespeichert werden. Wenn Sie Windows verwenden, laden Sie es herunter und installieren Sie es. Wenn Sie mit OS X arbeiten, müssen Sie dies über das Terminal erledigen. Verwenden Sie zum Starten diesen Befehl, um den Hilfsprogramm für Anmeldeinformationen herunterzuladen:

curl -s -O \

//github-media-downloads.s3.amazonaws.com/osx/git-credential-osxkeychain

Dies lädt eine winzige Datei herunter und sollte nicht zu lange dauern. Wenn Sie fertig sind, geben Sie den folgenden Befehl ein, um sicherzustellen, dass die Berechtigungen für die gerade heruntergeladene Datei korrekt sind (und korrigieren Sie sie, falls nicht):

chmod u+x git-credential-osxkeychain

Jetzt ist es an der Zeit, den Anmeldeinformationshilfen in demselben Ordner zu installieren, in dem Sie git installieren. Geben Sie dazu den folgenden Befehl ein:

sudo mv git-credential-osxkeychain `dirname \`which git\``

Sie werden aufgefordert, Ihr Administratorkennwort einzugeben, da der obige Befehl mit sudo begann. Sudo ist die Abkürzung für "Super User Do" und ist erforderlich, wenn eine Aufgabe ausgeführt wird, für die Root-Zugriff erforderlich ist. Mit dem Befehl sudo können Sie für einen Moment der Root-Benutzer (ein Benutzer mit der Berechtigung, so ziemlich alles zu tun) auf Ihrem Betriebssystem werden, um diese Aufgabe ausführen zu können. Sie werden aufgefordert, Ihr Kennwort einzugeben, um zu beweisen, dass Sie ein Administrator auf dem Computer sind, und sollten dazu berechtigt sein. Schließen Sie die Installation mit dem folgenden Befehl ab, nachdem Sie Ihr Kennwort eingegeben haben und das Hilfsprogramm für Anmeldeinformationen verschoben wurde:

git config --global credential.helper osxkeychain

Jetzt sind Sie fertig und können mit Git und GitHub weitermachen!

Vierter Schritt: Erstellen Sie Ihr erstes Repository

Jetzt, da Sie es soweit geschafft haben, können Sie GitHub tatsächlich verwenden! Als erste Aufgabe erstellen wir ein Repository (oder kurz "Repo"). Gehen Sie zu GitHub und klicken Sie auf die Schaltfläche "Neues Repository" oben rechts auf Ihrer Kontoseite. (Hinweis: Wenn Sie immer noch den GitHub-Bootcamp-Bereich anzeigen, wird er darunter angezeigt.)

Wenn Sie ein Repository erstellen, müssen Sie einige Dinge entscheiden, darunter den Namen und ob es öffentlich zugänglich sein soll oder nicht. Die Auswahl eines Namens sollte ziemlich einfach sein, da Sie wahrscheinlich bereits einen Namen für Ihr Projekt haben. Wenn Sie nur zu Lernzwecken mitlesen, verwenden Sie "Hello-World". Warum "Hello-World" und nicht "Hello World"? Weil Leerzeichen und Sonderzeichen Probleme verursachen. Halten Sie es einfach und leicht in der Befehlszeile einzugeben. Wenn Sie einen komplexeren Namen einfügen möchten, können Sie ihn dem optionalen Beschreibungsfeld unter dem Namensfeld hinzufügen.

Wenn Sie ein Open Source-Projekt erstellen, möchten Sie ein öffentliches Repository. Wenn Sie selbst codieren oder nur für bestimmte Personen freigeben möchten, reicht ein privates Repository aus. Treffen Sie die Wahl, die für Sie und Ihr Projekt am besten geeignet ist.

Wenn Sie fertig sind, können Sie auf die Schaltfläche "Repository erstellen" klicken. Möglicherweise möchten Sie jedoch zunächst Folgendes tun: Aktivieren Sie das Kontrollkästchen "Dieses Repository mit einer README-Datei initialisieren". Warum? Alle Repositorys erfordern eine README-Datei. Im Idealfall enthält diese Datei ein wenig Informationen zu Ihrem Projekt, aber Sie möchten sich möglicherweise im Moment nicht damit befassen. Wenn Sie das Repository mit einer README-Datei initialisieren, erhalten Sie eine leere README-Datei, die Sie später bearbeiten können. In diesem Tutorial verlassen wir die Box, weil wir im nächsten Abschnitt eine README-Datei von Grund auf erstellen, um zu üben, sie an GitHub zu übertragen (zu senden).

Fünfter Schritt: Machen Sie Ihr erstes Commit

Wenn Sie Dateien an GitHub senden, werden Sie diese. Zum Üben werden wir Ihr lokales Repository initialisieren und eine README-Datei erstellen, um sie als Übung zu übernehmen. Bevor Sie beginnen, müssen Sie wissen, wo sich Ihr lokales Code-Repository auf Ihrem Computer befindet und wie Sie über die Befehlszeile darauf zugreifen können. In diesem Tutorial wird davon ausgegangen, dass sich im Basisordner Ihres Computers ein Verzeichnis mit dem Namen "Hello-World" befindet. Wenn Sie einen erstellen müssen, führen Sie einfach diesen Befehl aus (dasselbe gilt für Git Bash auf dem Windows- und OS X-Terminal):

mkdir ~/Hello-World

Wechseln Sie nun mit dem Befehl cd (change directory) in dieses Verzeichnis:

cd ~/Hello-World

Für den Fall, dass Sie sich fragen, steht das ~ für Ihr Home-Verzeichnis in Git Bash und Terminal. Es ist einfach eine Kurzform, damit Sie nicht alles eingeben müssen (was eher nach / Users / yourusername / aussehen würde). Nachdem Ihr Repository fertig ist, geben Sie Folgendes ein:

git init

Wenn Sie bereits ein Repository bereit hatten, müssen Sie nur in dieses Verzeichnis git init und stattdessen den Befehl git init ausführen. In jedem Fall ist Ihr lokales Repository einsatzbereit und Sie können mit dem Festschreiben von Code beginnen. Aber warte, du hast nichts zu tun! Führen Sie diesen Befehl aus, um eine README-Datei zu erstellen:

touch README

Machen wir eine kurze Pause und sehen, was gerade passiert ist. Gehen Sie in den Home-Ordner auf Ihrem Computer und suchen Sie den Hello-World-Ordner (oder suchen Sie den Ordner, den Sie für ein lokales Repository verwenden). Dank des Befehls, den Sie gerade ausgeführt haben, werden Sie eine README-Datei darin bemerken. Was Sie nicht sehen, ist ein .git-Ordner, aber das liegt daran, dass er unsichtbar ist. Git versteckt es dort, aber weil Sie den Befehl git init ausgeführt haben, wissen Sie, dass es existiert. Wenn Sie skeptisch sind, führen Sie einfach den Befehl ls in Git Bash / Terminal aus, um eine Liste aller Elemente im aktuellen Verzeichnis anzuzeigen (das, wenn Sie mitlesen, Ihr lokales Repository ist).

Woher weiß git, dass wir diese soeben erstellte README-Datei festschreiben möchten? Das tut es nicht und du musst es sagen. Dieser Befehl erledigt den Trick:

git add README

Wenn Sie weitere Dateien zum Festschreiben hinzufügen möchten, verwenden Sie denselben Befehl, ersetzen jedoch README durch den Namen einer anderen Datei. Führen Sie nun diesen Befehl aus, um das Commit auszuführen:

git commit -m 'first commit'

Während die anderen Befehle ziemlich unkompliziert waren, hat der Commit-Befehl etwas mehr zu bieten, also lasst es uns zusammenfassen. Wenn Sie git, wird der Befehlszeile lediglich mitgeteilt, dass Sie das Programm git verwenden möchten. Wenn Sie commit eingeben, teilen Sie git mit, dass Sie den commit-Befehl verwenden möchten. Alles, was diesen beiden Dingen folgt, gilt als Option. Das erste ist, was als Flagge bekannt ist. Ein Flag gibt an, dass Sie etwas Besonderes tun möchten, anstatt nur den Commit-Befehl auszuführen. In diesem Fall bedeutet das Flag -m "message", und was darauf folgt, ist Ihre Festschreibungsnachricht (im Beispiel "first commit"). Die Nachricht ist nicht unbedingt erforderlich (obwohl Sie normalerweise eine angeben müssen), sondern lediglich eine Referenz, die Ihnen hilft, die verschiedenen Versionen einer Datei (oder von Dateien) zu unterscheiden, die Sie in Ihrem Repository festschreiben.

Ihr erster Commit sollte in Sekundenbruchteilen vergehen, da Sie noch nichts hochgeladen haben. Um diese leere README-Datei zu GitHub zu bringen, müssen Sie sie mit ein paar Befehlen pushen. Hier ist der erste:

git remote add origin //github.com/yourusername/Hello-World.git

Sie müssen "Ihren Benutzernamen" durch Ihren GitHub-Benutzernamen ersetzen - Sie haben es erraten. Für mich würde es so aussehen:

git remote add origin //github.com/gittest1040/Hello-World.git

Dieser Befehl teilt git mit, wohin Ihr Hello-World-Repository gesendet werden soll. Jetzt müssen Sie es nur noch senden:

git push origin master

Sobald Sie diesen Befehl ausgeführt haben, gelangt alles (in diesem Fall nur Ihre README-Datei) zu GitHub. Herzlichen Glückwunsch zum ersten Commit!

Mehr lernen

Das Verwenden von GitHub erfordert mehr als nur das Festschreiben einer README-Datei. Diese Grundlagen sollten Ihnen jedoch einen guten Einblick in die Interaktion mit der Git-App und dem Dienst geben. Nachdem Sie nun wissen, wie GitHub im Kern funktioniert, können Sie stattdessen die GitHub-Apps verwenden, um Ihren Code zu verwalten. Wenn Sie mehr über GitHub erfahren möchten, gibt es einige großartige Tutorials. Schauen Sie sich zunächst an, wie Sie ein Repository und den GitHub-Leitfaden von LockerGnome teilen.

Viel Spaß beim Verwalten deines Codes!

Liebe,

Goldavelez.com