Informationen zu GitHub Pages

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 Enterprise 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.

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 Enterprise gehostet wird, z. B. einer JavaScript-Bibliothek oder einer Rezeptsammlung. Benutzer- und Organisations-Websites sind mit einem bestimmten GitHub Enterprise-Konto verbunden.

To publish a user site, you must create a repository owned by your user account that's named <user>.<hostname>. To publish an organization site, you must create a repository owned by an organization that's named <organization>.<hostname>.

Die Quelldateien für eine Projekt-Website werden im selben Repository gespeichert wie das zugehörige Projekt.

Sie können für jedes GitHub Enterprise-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.

Unter welcher URL Ihre Website erreichbar ist, hängt davon ab, ob die Subdomain-Isolation für Ihre GitHub Enterprise Server-Instanz aktiviert ist.

http(s)://pages.<hostname>/<username>/<repository>/ | http(s)://<hostname>/pages/<username>/<repository>/ | Organisation | http(s)://pages.<hostname>/<organization>/<repository>/ | http(s)://<hostname>/pages/<organization>/<repository>/ | Projekt-Website, die einem Benutzerkonto gehört | http(s)://pages.<hostname>/<username>/<repository>/ | http(s)://<hostname>/pages/<username>/<repository>/ Projekt-Website, die einer Organisation gehört | http(s)://pages.<hostname>/<orgname>/<repository>/ | http(s)://<hostname>/pages/<orgname>/<repository>/

Weitere Informationen finden Sie unter „Subdomain-Isolation aktivieren“. Bei Fragen können Sie sich auch an den Websiteadministrator wenden.

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.

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, aus dem /docs-Ordner.

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 unterliegen den folgenden Nutzungseinschränkungen:

• Für GitHub Pages-Quell-Repositorys gilt eine empfohlene Beschränkung von 1 GB.
• Veröffentlichte GitHub Pages-Websites dürfen nicht größer als 1 GB sein.

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

• GitHub Pages auf GitHub Learning Lab
• „GitHub Pages“ in die GitHub-Entwicklerdokumentation