Informationen zu 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 Server bezieht, diese Dateien optional einem Build-Prozess unterzieht und eine Website veröffentlicht. Beispiele für GitHub Pages-Websites findest Du in der GitHub Pages-Beispielsammlung.
Informationen zu den ersten Schritten findest Du 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 Server gehostet wird, z. B. einer JavaScript-Bibliothek oder einer Rezeptsammlung. Benutzer- und Organisations-Websites sind mit einem bestimmten GitHub Enterprise Server-Konto verbunden.
To publish a user site, you must create a repository owned by your user account that's named <username>.<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.
You can only create one user or organization site for each account on GitHub Enterprise Server. Für Projekt-Websites gibt es keine Beschränkung, egal, ob sie einer Organisation oder einem Benutzerkonto gehören.
The URL where your site is available depends on whether subdomain isolation is enabled for your GitHub Enterprise Server instance.
Art der Website | Subdomänen-Isolation aktiviert | Subdomänen-Isolation deaktiviert |
---|---|---|
User |
http(s)://pages.<hostname>/<username>
| http(s)://<hostname>/pages/<username>
| Organization | http(s)://pages.<hostname>/<organization>
| http(s)://<hostname>/pages/<organization>
| Project site owned by user account | http(s)://pages.<hostname>/<username>/<repository>/
| http(s)://<hostname>/pages/<username>/<repository>/
Project site owned by organization account | http(s)://pages.<hostname>/<orgname>/<repository>/
| http(s)://<hostname>/pages/<orgname>/<repository>/
Weitere Informationen findest Du unter „Subdomänen-Isolation aktivieren“. Bei Fragen kannst Du Dich auch an den Websiteadministrator wenden.
Veröffentlichungsquellen für GitHub Pages-Websites
The publishing source for your GitHub Pages site is the branch and folder where the source files for your site are stored.
Warning: If your site administrator has enabled Public Pages, GitHub Pages sites are publicly available on the internet, even if the repository for the site is private. Wenn Du sensitive Daten im Repository Deiner Website hast, solltest Du diese vor der Veröffentlichung entfernen. For more information, see "Configuring GitHub Pages for your enterprise" and "About repository visibility."
Die standardmäßige Veröffentlichungsquelle für Benutzer- und Organisations-Websites ist der master
-Branch. Wenn das Repository Deiner Benutzer- oder Organisations-Website einen master
-Branch aufweist, wird Deine Website automatisch von diesem Branch veröffentlicht. Du kannst 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 Deiner Projekt-Website einen gh-pages
-Branch aufweist, wird Deine Website automatisch von diesem Branch veröffentlicht.
Du kannst Projekt-Websites auch vom master
-Branch oder einem /docs
-Ordner auf dem master
-Branch veröffentlichen. Um Deine Website aus einer dieser Quellen zu veröffentlichen, musst Du eine andere Veröffentlichungsquelle konfigurieren. Weitere Informationen findest Du unter „Eine Veröffentlichungsquelle für Deine GitHub Pages-Website konfigurieren.“
If you choose the /docs
folder of the master
branch as your publishing source, GitHub Pages will read everything to publish your site from the /docs
folder.
Du kannst Deine Projekt-Website nicht aus einem anderen Branch veröffentlichen, auch wenn der Standard-Branch nicht Master
oder gh-pages
ist.
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:
- GitHub Pages source repositories have a recommended limit of 1GB.
- 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 findest Du in den Beitragsrichtlinien für mime-db.
Weiterführende Informationen
- GitHub Pages auf GitHub Learning Lab
- "GitHub Pages"