Hallo, Entdecker! An dieser Seite wird aktiv gearbeitet, oder sie wird noch übersetzt. Die neuesten und genauesten Informationen finden Sie in unserer englischsprachigen Dokumentation.
Artikelversion: GitHub.com

Informationen zu GitHub Pages

Mit GitHub Pages können Sie eine Website zu Ihrer Person, Ihrer Organisation oder Ihrem Projekt direkt aus einem GitHub-Repository hosten.

GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub's products."

Inhalt dieses Artikels

Informationen zum GitHub Pages

GitHub Pages ist ein Hosting-Dienst für statische Websites, der HTML-, CSS- und JavaScript-Dateien direkt aus einem Repository auf GitHub bezieht, diese Dateien optional einem Build-Prozess unterzieht und eine Website veröffentlicht. Beispiele für GitHub Pages-Websites finden Sie in der GitHub Pages-Beispielsammlung.

Sie können Ihre Website auf der Domain github.io von GitHub oder Ihrer eigenen benutzerdefinierten Domain hosten. Weitere Informationen finden Sie unter „Eine benutzerdefinierte Domain mit GitHub Pages verwenden“.

Informationen zu den ersten Schritten finden Sie unter „Eine GitHub Pages-Website erstellen“.

Arten von GitHub Pages-Websites

Es gibt drei Arten von GitHub Pages-Websites: Projekt-, Benutzer- und Organisations-Websites. Projekt-Websites sind mit einem bestimmten Projekt verbunden, das auf GitHub gehostet wird, z. B. einer JavaScript-Bibliothek oder einer Rezeptsammlung. Benutzer- und Organisations-Websites sind mit einem bestimmten GitHub-Konto verbunden.

Benutzer- und Organisations-Websites werden immer aus einem Repository mit dem Namen <user>.github.io oder <organization>.github.io veröffentlicht. Wenn Sie keine benutzerdefinierte Domain verwenden, sind Benutzer- und Organisations-Websites unter http(s)://<username>.github.io oder http(s)://<organization>.github.io erreichbar.

Die Quelldateien für eine Projekt-Website werden im selben Repository gespeichert wie das zugehörige Projekt. Wenn Sie keine benutzerdefinierte Domain verwenden, sind Projekt-Websites unter http(s)://<user>.github.io/<repository> oder http(s)://<organization>.github.io/<repository> erreichbar.

Weitere Informationen dazu, wie sich die URL Ihrer Website bei benutzerdefinierten Domains ändert, finden Sie unter „Informationen zu benutzerdefinierten Domains und GitHub Pages“.

Sie können für jedes GitHub-Konto nur eine Benutzer- oder Organisations-Website erstellen. Für Projekt-Websites gibt es keine Beschränkung, egal, ob sie einer Organisation oder einem Benutzerkonto gehören.

Hinweis: Repositorys, die das alte Namensschema <user>.github.com verwenden, werden noch veröffentlicht, aber Besucher werden von http(s)://<username>.github.com auf http(s)://<username>.github.io weitergeleitet. Wenn sowohl ein <user>.github.com- als auch ein <user>.github.io-Repository vorhanden ist, wird nur das <user>.github.io-Repository veröffentlicht.

Veröffentlichungsquellen für GitHub Pages-Websites

Die Veröffentlichungsquelle für Ihre GitHub Pages-Website ist der Branch oder Ordner, in dem die Quelldateien für Ihre Website gespeichert sind. Alle Websites haben eine Standard-Veröffentlichungsquelle. Für Projekt-Websites sind zusätzliche Veröffentlichungsquellen verfügbar.

Warning: GitHub Pages sites are publicly available on the internet, even if their repositories are private or internal. If you have sensitive data in your site's repository, you may want to remove it before publishing. For more information, see "About repository visibility."

Die standardmäßige Veröffentlichungsquelle für Benutzer- und Organisations-Websites ist der master-Branch. Wenn das Repository Ihrer Benutzer- oder Organisations-Website einen master-Branch aufweist, wird Ihre Website automatisch von diesem Branch veröffentlicht. Sie können keine andere Veröffentlichungsquelle für Benutzer- oder Organisations-Websites auswählen.

Die standardmäßige Veröffentlichungsquelle für Projekt-Websites ist der gh-pages-Branch. Wenn das Repository Ihrer Projekt-Website einen gh-pages-Branch aufweist, wird Ihre Website automatisch von diesem Branch veröffentlicht.

Sie können Projekt-Websites auch vom master-Branch oder einem /docs-Ordner auf dem master-Branch veröffentlichen. Um Ihre Website aus einer dieser Quellen zu veröffentlichen, müssen Sie eine andere Veröffentlichungsquelle konfigurieren. Weitere Informationen finden Sie unter „Eine Veröffentlichungsquelle für Ihre GitHub Pages-Website konfigurieren“.

Wenn Sie den /docs-Ordner des master-Branches als Veröffentlichungsquelle auswählen, liest GitHub Pages alle Informationen, die zum Veröffentlichen Ihrer Website erforderlich sind,, einschließlich der CNAME-Datei, aus dem /docs-Ordner. Wenn Sie beispielsweise Ihre benutzerdefinierte Domain in den GitHub Pages-Einstellungen bearbeiten, schreibt die benutzerdefinierte Domain in /docs/CNAME. Weitere Informationen zu CNAME-Dateien finden Sie unter „Eine benutzerdefinierte Domain für Ihre GitHub Pages-Website verwalten“.

You cannot publish your project site from any other branch, even if the default branch is not master or gh-pages.

Generatoren für statische Websites

GitHub Pages veröffentlicht alle statische Dateien, die Sie zu Ihrem Repository pushen. Sie können eigene statische Dateien erstellen oder einen Generator für statische Websites verwenden, der die Website für Sie erstellt. Darüber hinaus können Sie Ihren eigenen Build-Prozess lokal oder auf einem anderen Server anpassen. Wir empfehlen Jekyll, einen Generator für statische Websites mit integrierter Unterstützung von GitHub Pages und einem vereinfachten Build-Prozess. Weitere Informationen finden Sie unter „Informationen zu GitHub Pages und Jekyll“.

GitHub Pages verwendet standardmäßig Jekyll für die Erstellung Ihrer Website. Wenn Sie einen anderen Generator für statische Websites als Jekyll verwenden möchten, müssen Sie den Jekyll-Build-Prozess deaktivieren. Erstellen Sie dazu im Root Ihrer Veröffentlichungsquelle eine leere Datei mit dem Namen .nojekyll und folgen den Anweisungen des gewünschten Generators, um Ihre Website lokal zu erstellen.

GitHub Pages unterstützt keine serverseitigen Sprachen wie PHP, Ruby oder Python.

Richtlinien für die Verwendung von GitHub Pages

  • GitHub Pages-Websites, die nach dem 15. Juni 2016 und mittels github.io-Domains erstellt wurden, werden über HTTPS bereitgestellt. Wenn Sie Ihre Website vor dem 15. Juni 2016 erstellt haben, können Sie die HTTPS-Unterstützung für den Traffic zu Ihrer Website aktivieren. Weitere Informationen finden Sie unter „GitHub Pages-Website mit HTTPS schützen“.

  • GitHub Pages-Websites sollten nicht für Transaktionen sensibler Daten verwendet werden, also beispielsweise nicht für das Senden von Passwörtern oder Kreditkartennummern.

  • Ihre Nutzung von GitHub Pages unterliegt den GitHub-Nutzungsbedingungen, einschließlich des Weiterverkaufsverbots.

Nutzungseinschränkungen

GitHub Pages unterliegen den folgenden Nutzungseinschränkungen:

  • Für GitHub Pages-Quell-Repositorys gilt eine empfohlene Beschränkung von 1 GB. Weitere Informationen finden Sie unter „Wie lautet mein Disk-Kontingent?

  • Veröffentlichte GitHub Pages-Websites dürfen nicht größer als 1 GB sein.

  • GitHub Pages-Websites besitzen eine weiche Bandbreitenbegrenzung von 100 GB pro Monat.

  • GitHub Pages-Websites besitzen eine weiche Begrenzung von 10 Builds pro Stunde.

Wenn Ihre Website diese Nutzungskontingente überschreitet, kann Ihre Website ggf. nicht bedient werden oder Sie erhalten eine höfliche E-Mail von [GitHub-Support]((https://support.github.com/contact) oder GitHub Premium-Support, in der Strategien vorgeschlagen werden, um die Auswirkung Ihrer Website auf unsere Server zu reduzieren. Dazu zählen das Einsetzen eines Drittanbieter-CDNs (Content Distribution Networks) vor Ihrer Website, die Nutzung anderer GitHub-Features, beispielsweise Veröffentlichungen, oder der Wechsel zu einem anderen Hosting-Dienst, der ggf. besser zu Ihren Anforderungen passt.

Verbotene Verwendungen

GitHub Pages soll oder darf nicht als kostenloser Web-Hosting-Dienst zum Betreiben Ihrer Online-Geschäfts-, E-Commerce-Website oder jeder anderen Website verwendet werden, die in erster Linie darauf ausgerichtet ist, kommerzielle Transaktionen zu erleichtern oder kommerzielle Software-as-a-Service-Lösungen (SaaS) bereitzustellen.

Zusätzlich darf in GitHub Pages-Websites Folgendes nicht enthalten sein:

  • Illegale oder gemäß unseren Nutzungsbedingungen oder den Community-Richtlinien untersagte Inhalte oder Aktivitäten
  • gewalttätige oder bedrohende Inhalte oder Aktivitäten
  • übermäßig automatisierte Massenaktivitäten (beispielsweise Spam)
  • GitHub-Benutzer oder GitHub-Dienste kompromittierende Aktivitäten
  • Schnell-reich-werden-Schemas
  • sexuell anstößige Inhalte
  • Ihre Identität oder den Zweck Ihrer Website falsch darstellende Inhalte

Wenden Sie sich an [GitHub-Support]((https://support.github.com/contact) oder GitHub Premium-Support, falls Sie Fragen dazu haben, ob Ihre Nutzung oder gewünschte Nutzung in eine dieser Kategorien fällt.

MIME-Typen auf GitHub Pages

Ein MIME-Typ ist ein Header, den ein Server an einen Browser übermittelt und der Informationen zur Art und zum Format der Dateien enthält, die der Browser angefordert hat. GitHub Pages unterstützt mehr als 750 MIME-Typen bei Tausenden von Dateierweiterungen. Die Liste der unterstützten MIME-Typen wird aus dem mime-db-Projekt erzeugt.

Zwar können Sie keine benutzerdefinierten MIME-Typen für einzelne Dateien oder Repositorys festlegen. Sie können jedoch MIME-Typen für die Verwendung auf GitHub Pages hinzufügen oder ändern. Weitere Informationen finden Sie in den Beitragsrichtlinien für mime-db.

Weiterführende Informationen

Menschliche Unterstützung einholen

Sie können das Gesuchte nicht finden?

Kontakt