Informationen zu GitHub Pages

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.

Weitere Informationen zu den ersten Schritten findest du unter Erstellen einer GitHub Pages-Website.

Organisationsbesitzer*innen können die Veröffentlichung von GitHub Pages-Websites aus Repositorys der Organisation deaktivieren. Weitere Informationen finden Sie unter Verwalten der Veröffentlichung von GitHub Pages-Websites für deine Organisation.

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 Organisationswebsites sind mit einem bestimmten Konto mit Ihre GitHub Enterprise Server-Instance verbunden.

Um eine Benutzerwebsite zu veröffentlichen, musst du ein Repository erstellen, das deinem persönlichen Konto mit dem Namen <username>.<hostname> gehört. Zum Veröffentlichen einer Organisationswebsite musst du ein Repository erstellen, das einer Organisation mit dem Namen <organization>.<hostname> gehört. verfügbar.

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

Du kannst für jedes Konto auf GitHub Enterprise Server nur eine Benutzer- oder Organisationswebsite erstellen. Für Projektwebsites gibt es keine Beschränkung, ganz gleich, ob sie einer Organisation oder einem Benutzerkonto gehören.

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

Standorttyp	Subdomänen-Isolation aktiviert	Subdomänen-Isolation deaktiviert
Benutzer	http(s)://pages.<hostname>/<username>	http(s)://<hostname>/pages/<username>
Organization	http(s)://pages.<hostname>/<organization>	http(s)://<hostname>/pages/<organization>
Projektwebsite im Besitz eines persönlichen Kontos	http(s)://pages.<hostname>/<username>/<repository>/	http(s)://<hostname>/pages/<username>/<repository>/
Project Website im Besitz eines Organisationskontos	http(s)://pages.<hostname>/<orgname>/<repository>/	http(s)://<hostname>/pages/<orgname>/<repository>/

Weitere Informationen erhältst du unter Subdomain-Isolation aktivieren oder von deinen Websiteadministratoren.

Veröffentlichungsquellen für GitHub Pages-Websites

Du kannst deine Website veröffentlichen, wenn Änderungen an einen bestimmten Branch gepusht werden, oder du kannst einen GitHub Actions-Workflow schreiben, um deine Website zu veröffentlichen. Um GitHub Actions als Veröffentlichungsquelle für GitHub Pages zu verwenden, muss ein Siteadministrator GitHub Actions für GitHub Enterprise Server aktivieren. Weitere Informationen findest du unter Aktivieren von GitHub Actions für GitHub Enterprise Server.

Wenn du keine Kontrolle über den Buildprozess für deine Website benötigst, wird empfohlen, deine Website zu veröffentlichen, wenn Änderungen an einen bestimmten Branch gepusht werden. Du kannst angeben, welcher Branch und welcher Ordner als Veröffentlichungsquelle verwendet werden sollen. Der Quellbranch kann ein beliebiger Branch in deinem Repository sein, und der Quellordner kann entweder der Stamm des Repositorys (/) im Quellbranch oder der Ordner /docs im Quellbranch sein. Wenn Änderungen an den Quellbranch gepusht werden, werden die Änderungen im Quellordner in deiner GitHub Pages-Website veröffentlicht.

Wenn du einen anderen Buildprozess als Jekyll verwenden möchtest oder nicht möchtest, dass deine kompilierten statischen Dateien in einem dedizierten Branch enthalten sind, wird empfohlen, einen GitHub Actions-Workflow zu schreiben, um deine Website zu veröffentlichen. GitHub Enterprise Server bietet Workflowvorlagen für häufiger vorkommende Veröffentlichungsszenarien, die Ihnen beim Schreiben von Workflows helfen.

Weitere Informationen finden Sie unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren.

Generatoren für statische Websites

GitHub Pages veröffentlicht alle statischen Dateien, die du an dein Repository pushst. Du kannst eigene statische Dateien erstellen oder einen Generator für statische Websites verwenden, der die Website für dich erstellt. Darüber hinaus kannst du deinen eigenen Buildprozess lokal oder auf einem anderen Server anpassen.

Wenn du statt Jekyll einen benutzerdefinierten Buildprozess oder einen anderen Generator für statische Websites verwendest, kannst du GitHub Actions schreiben, um deine Website zu erstellen und zu veröffentlichen. GitHub Enterprise Server bietet Workflowvorlagen für mehrere Generatoren für statische Websites. Weitere Informationen finden Sie unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren.

Wenn du deine Website von einem Quellbranch aus veröffentlichst, verwendet GitHub Pages standardmäßig Jekyll zum Erstellen deiner Website. Wenn du statt Jekyll einen anderen Generator für statische Websites verwenden möchtest, empfehlen wir, stattdessen GitHub Actions zu schreiben, um deine Website zu erstellen und zu veröffentlichen. Anderenfalls deaktiviere den Jekyll-Buildprozess, indem du im Stamm deiner Veröffentlichungsquelle eine leere Datei namens .nojekyll erstellst, und befolge dann die Anweisungen des gewünschten Generators für statische Websites, um deine Website lokal zu erstellen.

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

Grenzwerte für die Verwendung von GitHub Pages

GitHub Pages soll oder darf nicht als kostenloser Webhostingdienst zum Betreiben deiner Onlinegeschäfts-, E-Commerce- oder sonstigen Website verwendet werden, die in erster Linie darauf ausgerichtet ist, gewerbliche Transaktionen zu vereinfachen oder kommerzielle Software-as-a-Service-Lösungen (SaaS) bereitzustellen. GitHub Pages-Websites sollten nicht für Transaktionen sensibler Daten verwendet werden, also beispielsweise nicht für das Senden von Passwörtern oder Kreditkartennummern.

Darüber hinaus unterliegt die Nutzung von GitHub Pages den GitHub-Nutzungsbedingungen, einschließlich der Beschränkungen für get-rich-quick-Schemas, sexuelle obszöne Inhalte und gewaltverherrlichende oder bedrohliche Inhalte oder Aktivitäten.

Lernübungen

Die Verwendung von GitHub Pages zum Erstellen einer Kopie einer vorhandenen Website als Lernübung ist zulässig. Zusätzlich zur Einhaltung der GitHub-Vertragsbedingungn müssen Sie den Code jedoch selbst schreiben, die Website darf keine Benutzerdaten sammeln, und Sie müssen auf der Website einen gut sichtbaren Haftungsausschluss angeben, aus dem hervorgeht, dass das Projekt nicht mit dem Original verknüpft ist und nur für Schulungszwecke erstellt wurde.

Usage limits (Nutzungseinschränkungen)

GitHub Pages unterliegen den folgenden Nutzungseinschränkungen:

• Für GitHub Pages-Quellrepositorys wird ein Grenzwert von 1 GB empfohlen.
• Veröffentlichte GitHub Pages-Websites dürfen nicht größer als 1 GB sein.
• GitHub Pages-Bereitstellungen führen zu einem Timeout, wenn sie länger als 10 Minuten dauern.

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

Zwar kannst du keine benutzerdefinierten MIME-Typen für einzelne Dateien oder Repositorys festlegen, aber du kannst MIME-Typen für die Verwendung auf GitHub Pages hinzufügen oder ändern. Weitere Informationen findest du in den Mime-db-Richtlinien.

Weiterführende Themen

• GitHub Pages für GitHub Skills
• REST-API-Endpunkte für Repositorys