Schnellstartanleitung für GitHub Pages

Du kannst mit GitHub Pages einige Open-Source-Projekte vorstellen, einen Blog hosten oder sogar deinen Lebenslauf freigeben. Dieser Leitfaden hilft dir bei der Erstellung deiner nächsten Website.

Wer kann dieses Feature verwenden?

GitHub Pages ist in öffentlichen Repositorys mit GitHub Free und GitHub Free für Organisationen sowie in öffentlichen und privaten Repositorys mit GitHub Pro, GitHub Team, GitHub Enterprise Cloud und GitHub Enterprise Server verfügbar. Weitere Informationen findest du unter GitHub-Pläne.

GitHub Pages verwendet nun GitHub Actions zur Ausführung des Jekyll-Builds. Wenn Sie einen Zweig als Quelle Ihres Builds verwenden, muss GitHub Actions in Ihrem Repository aktiviert sein, wenn Sie den eingebauten Jekyll-Workflow verwenden möchten. Wenn GitHub Actions nicht verfügbar oder deaktiviert ist, können Sie alternativ eine .nojekyll-Datei zum Stamm Ihrer Quellverzweigung hinzufügen, um den Jekyll-Erstellungsprozess zu umgehen und den Inhalt direkt bereitzustellen. Weitere Informationen zur Aktivierung von GitHub Actions finden Sie unter „Verwalten von GitHub Actions-Einstellungen für ein Repository“

In diesem Artikel

Einführung

GitHub Pages sind über GitHub gehostete und veröffentlichte öffentliche Webseiten. Am schnellsten geht es, wenn du den Jekyll Theme Chooser benutzt, um ein vorgefertigtes Design zu laden. Anschließend kannst du deinen GitHub Pages-Inhalt und das Format ändern.

Dieser Leitfaden führt dich durch das Erstellen einer Benutzerwebsite unter username.github.io.

Erstellen deiner Website

  1. Wähle in der rechten oberen Ecke einer beliebigen Seite , und klicke dann auf Neues Repository.

    Screenshot eines GitHub-Dropdownmenüs mit Optionen zum Erstellen neuer Elemente. Das Menüelement „Neues Repository“ ist in dunklem Orange eingerahmt.

  2. Gib username.github.io als Repositorynamen ein. Ersetze username durch deinen GitHub-Benutzernamen. Wenn dein Benutzername beispielsweise octocat lautet, sollte der Repositoryname octocat.github.io sein.

    Screenshot der GitHub Pages-Einstellungen in einem Repository. Das Feld „Repositoryname“ enthält den Text „octocat.github.io“ und ist in dunklem Orange eingerahmt.

  3. Wähle eine Sichtbarkeitsoption für das Repository aus. Weitere Informationen findest du unter Informationen zu Repositorys.

  4. Aktivieren Sie das Kontrollkästchen Initialize this repository with a README (Dieses Repository mit einer README-Datei initialisieren).

  5. Klicke auf Repository erstellen.

  6. Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  7. Klicke im Abschnitt „Code und Automatisierung“ der Seitenleiste auf Seiten.

  8. Wähle unter „Erstellen und Bereitstellen“ unter „Quelle“ die Option Aus einem Branch bereitstellen aus.

  9. Wähle unter „Build & Deployment“ unter „Branch“ im Dropdownmenü „Branch“ eine Veröffentlichungsquelle aus.

    Screenshot der Pages-Einstellungen in einem GitHub-Repository. Ein Menü zum Auswählen eines Branchs für eine Veröffentlichungsquelle mit der Bezeichnung „Keine“ ist in dunklem Orange eingerahmt.

  10. Öffne optional die Datei README.md deines Repositorys. In die README.md-Datei schreibst du den Inhalt deiner Website. Du kannst die Datei bearbeiten oder den Standardinhalt vorerst beibehalten.

  11. Besuche auf username.github.io deine neue Website. Es kann bis zu 10 Minuten dauern, bis die Änderungen an deiner Website veröffentlicht werden, nachdem du die Änderung an GitHub gepusht hast.

Ändern des Titels und der Beschreibung

Standardmäßig lautet der Titel deiner Website username.github.io. Du kannst den Titel ändern, indem du die _config.yml-Datei in deinem Repository bearbeitest. Du kannst auch eine Beschreibung für deine Website hinzufügen.

  1. Klicke auf die Registerkarte Code deines Repositorys.

  2. Klicke in der Dateiliste auf _config.yml, um die Datei zu öffnen.

  3. Klicke auf , um die Datei zu bearbeiten.

  4. Die _config.yml-Datei enthält bereits eine Zeile, die das Design für deine Website angibt. Füge eine neue Zeile mit title: gefolgt von dem gewünschten Titel hinzu. Füge eine neue Zeile mit description: gefolgt von der gewünschten Beschreibung hinzu. Beispiel:

    theme: jekyll-theme-minimal
title: Octocat's homepage
description: Bookmark this to keep an eye on my project updates!

  5. Wenn du mit der Bearbeitung der Datei fertig bist, klicke auf Änderungen committen.

Nächste Schritte

Weitere Informationen zum Hinzufügen zusätzlicher Seiten zu deiner Website findest du unter Inhalte zur GitHub Pages-Website mit Jekyll hinzufügen.

Weitere Informationen zum Einrichten einer GitHub Pages-Website mit Jekyll findest du unter Informationen zu GitHub Pages und Jekyll.