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.
Um eine Benutzerwebsite zu veröffentlichen, musst Du ein Repository erstellen, das Deinem Benutzerkonto gehört und den Namen <username>.<hostname>
hat. Um eine Organisations-Website zu veröffentlichen, musst du ein Repository erstellen, das einer Organisation gehört, die <organization>.<hostname>
heißt.
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.
Unter welcher URL Ihre Website erreichbar ist, hängt davon ab, ob die Subdomain-Isolation für your GitHub Enterprise Server instance aktiviert ist.
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>/
For more information, see "Enabling subdomain isolation" or contact your site administrator.
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 or internal. If you have sensitive data in your site's repository, you may want to remove the data before publishing. For more information, see "Configuring GitHub Pages for your enterprise" and "About repositories."
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.“
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.
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:
- 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 findest Du in den Beitragsrichtlinien für mime-db.
Weiterführende Informationen
- GitHub Pages auf GitHub Learning Lab
- "GitHub Pages"