Wie verwende ich GitHub Pages?
GitHub ist eine Seite für "soziales Programmieren". Sie ermöglicht es Ihnen, Code-Repositories zur Speicherung im Git Versionskontrollsystem hochzuladen. Sie können dann an Code-Projekten zusammenarbeiten, und das System ist standardmäßig Open Source, was bedeutet, dass jeder auf der Welt Ihren GitHub-Code finden, verwenden, daraus lernen und ihn verbessern kann. Das können Sie auch mit dem Code anderer Leute tun! Dieser Artikel bietet einen grundlegenden Leitfaden zum Veröffentlichen von Inhalten mit der gh-pages-Funktion von GitHub.
Inhalte veröffentlichen
GitHub ist eine sehr wichtige und nützliche Community, an der Sie teilnehmen können, und Git/GitHub ist ein sehr beliebtes Versionskontrollsystem — die meisten Technologieunternehmen verwenden es mittlerweile in ihrem Arbeitsablauf. GitHub hat eine sehr nützliche Funktion namens GitHub Pages, die es ermöglicht, Website-Code live im Web zu veröffentlichen.
Grundlegende GitHub-Einrichtung
- Installieren Sie zunächst Git auf Ihrem Rechner. Dies ist die zugrunde liegende Software des Versionskontrollsystems, auf dem GitHub aufbaut.
- Erstellen Sie als Nächstes ein GitHub-Konto. Es ist einfach und unkompliziert.
- Nachdem Sie sich angemeldet haben, loggen Sie sich mit Ihrem Benutzernamen und Passwort bei github.com ein.
Ihren Code für den Upload vorbereiten
Sie können jeden gewünschten Code in einem GitHub-Repository speichern, aber um die GitHub Pages-Funktion optimal zu nutzen, sollte Ihr Code wie eine typische Website strukturiert sein, z. B. mit einem primären Einstiegspunkt in Form einer HTML-Datei namens index.html
.
Bevor Sie fortfahren, müssen Sie auch Ihr Codeverzeichnis als Git-Repository initialisieren. Um dies zu tun:
-
Navigieren Sie mit der Befehlszeile zu Ihrem
test-site
-Verzeichnis (oder wie auch immer Sie das Verzeichnis mit Ihrer Website nennen). Verwenden Sie dafür dencd
-Befehl (d.h. "change directory"). So würden Sie es eingeben, wenn sich Ihre Website in einem Verzeichnis namenstest-site
auf Ihrem Desktop befindet:bashcd Desktop/test-site
-
Wenn die Befehlszeile in Ihr Website-Verzeichnis zeigt, geben Sie den folgenden Befehl ein, der dem
git
-Tool mitteilt, das Verzeichnis in ein Git-Repository zu verwandeln:bashgit init
Eine Randbemerkung zu Befehlszeilenschnittstellen
Der beste Weg, Ihren Code auf GitHub hochzuladen, ist über die Befehlszeile - dies ist ein Fenster, in dem Sie Befehle eingeben, um Dinge wie das Erstellen von Dateien und das Ausführen von Programmen zu erledigen, anstatt in einer Benutzeroberfläche zu klicken. Es sieht ungefähr so aus:
Hinweis: Sie könnten auch in Betracht ziehen, eine Git-Grafikbenutzeroberfläche zu verwenden, um die gleiche Arbeit zu erledigen, wenn Sie sich mit der Befehlszeile unwohl fühlen.
Jedes Betriebssystem verfügt über ein Befehlszeilenwerkzeug:
- Windows: Eingabeaufforderung kann durch Drücken der Windows-Taste, Eingabe von Eingabeaufforderung und Auswahl aus der erscheinenden Liste geöffnet werden. Beachten Sie, dass Windows eigene Befehlskonventionen hat, die sich von Linux und macOS unterscheiden, weshalb die Befehle unten auf Ihrem Computer abweichen können.
- macOS: Terminal ist unter Programme > Dienstprogramme zu finden.
- Linux: In der Regel können Sie ein Terminal mit Strg + Alt + T öffnen. Wenn das nicht funktioniert, suchen Sie nach Terminal in einer App-Leiste oder im Menü.
Dies mag zunächst etwas beängstigend erscheinen, aber keine Sorge — Sie werden sich schnell mit den Grundlagen vertraut machen. Sie befehlen dem Computer, indem Sie einen Befehl eingeben und die Eingabetaste drücken, wie oben gezeigt.
Ein Repository für Ihren Code erstellen
- Als Nächstes müssen Sie ein neues Repository für Ihre Dateien erstellen. Klicken Sie auf das Plus-Symbol (+) oben rechts auf der GitHub-Startseite und wählen Sie Neues Repository.
- Geben Sie auf dieser Seite im Feld Repository-Name einen Namen für Ihr Code-Repository ein, zum Beispiel mein-repository.
- Füllen Sie auch eine Beschreibung aus, die angibt, was Ihr Repository enthalten wird. Ihr Bildschirm sollte so aussehen:
- Klicken Sie auf Repository erstellen; dies sollte Sie zu folgender Seite führen:
Ihre Dateien auf GitHub hochladen
-
Auf der aktuellen Seite interessiert Sie der Abschnitt …or push an existing repository from the command line. Sie sollten zwei Zeilen Code in diesem Abschnitt aufgelistet sehen. Kopieren Sie die erste Zeile vollständig, fügen Sie sie in die Befehlszeile ein und drücken Sie Enter. Der Befehl sollte ungefähr so aussehen:
bashgit remote add origin https://github.com/chrisdavidmills/my-repository.git
-
Geben Sie als Nächstes die folgenden zwei Befehle ein und drücken Sie nach jedem die Eingabetaste. Diese bereiten den Code für den Upload auf GitHub vor und weisen Git an, diese Dateien zu verwalten.
bashgit add --all git commit -m 'adding my files to my repository'
-
Schieben Sie schließlich den Code zu GitHub, indem Sie zur GitHub-Webseite gehen, auf der Sie sich gerade befinden, und den zweiten der beiden Befehle, die wir im Abschnitt …or push an existing repository from the command line gesehen haben, ins Terminal eingeben:
bashgit push -u origin main
-
Jetzt müssen Sie GitHub Pages für Ihr Repository aktivieren. Um dies zu tun, wählen Sie auf der Startseite Ihres Repositories Einstellungen und dann Seiten in der Seitenleiste links. Unter Quelle wählen Sie den "main"-Zweig. Die Seite sollte aktualisiert werden.
-
Gehen Sie erneut zum GitHub Pages-Bereich, und Sie sollten eine Zeile der Form "Ihre Seite ist bereit, unter
https://xxxxxx
veröffentlicht zu werden." sehen. -
Wenn Sie auf diese URL klicken, sollten Sie zu einer Live-Version Ihres Beispiels gelangen, vorausgesetzt, die Homepage heißt
index.html
— diese wird automatisch als Einstiegspunkt verwendet. Wenn der Einstiegspunkt Ihrer Seite anders heißt, zum BeispielmeineSeite.html
, müssen Sie zuhttps://xxxxxx/meineSeite.html
gehen.
Weiterführende GitHub-Kenntnisse
Wenn Sie weitere Änderungen an Ihrer Testseite vornehmen und diese auf GitHub hochladen möchten, müssen Sie die Änderung an Ihren Dateien genauso vornehmen wie zuvor. Dann müssen Sie die folgenden Befehle eingeben (nach jedem die Eingabetaste drücken), um diese Änderungen auf GitHub hochzuladen:
git add --all
git commit -m 'another commit'
git push
Sie können ein weiterer Commit durch eine passendere Nachricht ersetzen, um zu beschreiben, welche Änderung Sie gerade vorgenommen haben.
Wir haben nur an der Oberfläche von Git gekratzt. Um mehr zu lernen, besuchen Sie unsere Git und GitHub Seite.