Artikelversion: Enterprise Server 2.17
Eine GitHub Pages-Website erstellen
Sie können eine GitHub Pages-Website in einem neuen oder vorhandenen Repository erstellen.
GitHub Pages ist verfügbar in öffentlichen Repositorys mitGitHub Free und GitHub Free für Organisationen, und in öffentlichen und privaten Repositorys mit GitHub Pro, GitHub Team, GitHub Enterprise Cloud, und GitHub Enterprise Server.
Ein Repository für eine Website erstellen
Wenn Deine Website ein unabhängiges Projekt ist, kannst Du ein neues Repository erstellen, um den Quellcode Deiner Website zu speichern. Wenn Deine Website einem existierenden Projekt zugeordnet ist, kannst Du den Quellcode für Deine Website zu einem gh-pages-Branch oder einem docs-Ordner im master-Branch dieses Projekt-Repository hinzufügen. Wenn Du beispielsweise eine Website erstellst, um Dokumentationen für ein Projekt zu veröffentlichen, das bereits auf GitHub Enterprise ist, kannst Du den Quellcode für die Website im selben Repository wie das Projekt speichern.
Wenn Du eine Website in einem vorhandenen Repository erstellen möchtest, springe zum Abschnitt „Erstellen Deiner Website".
Warnung: GitHub Pages-Websites sind im Internet öffentlich zugänglich wenn Dein Websiteadministrator „Public Pages" (Öffentliche Seiten) aktiviert hat, auch wenn ihre Repositorys privat sind. Wenn Du sensitive Daten im Repository Deiner Website hast, solltest Du diese vor der Veröffentlichung entfernen. Weitere Informationen findest Du unter „Konfigurieren GitHub Pages auf Deiner Appliance" und „Über die Sichtbarkeit des Repositorys."
- Benutze in der oberen rechten Ecke einer beliebigen Seite das -Dropdownmenü und wähle New Repository (Neues Repository).
- Verwende das Dropdownmenü Owner (Inhaber) und wähle das Konto, das das Repository besitzen soll.
- Gib einen Namen sowie eine optionale Beschreibung für Dein Repository ein. Wenn Du eine Benutzer- oder Organisationswebsite erstellst, muss Dein Repository den Namen
<user>.github.ioor<organization>.github.iohaben. Weitere Informationen findest Du unter „Informationen zu GitHub Pages“.
- Wähle die Sichtbarkeit des Repository. Weitere Informationen findest Du unter „Über Sichtbarkeit von Repositorys."
- Wähle Initialize this repository with a README (Dieses Repository mit einer README-Datei initialisieren).
- Klicke auf Create repository (Repository erstellen).
Eine Website erstellen
Bevor Du Deine Website erstellen kannst, musst Du ein Repository für Deine Website auf GitHub Enterprise haben. Wenn Du Deine Website nicht in einem vorhandenen Repository erstellst, findest Du weitere Informationen unter „Erstellen eines Repositorys für Deine Website."
-
Navigiere in GitHub Enterprise zum Repository Deiner Website.
-
Wenn Du eine Projektwebsite erstellst, entscheide, welche Veröffentlichungsquelle Du verwenden möchtest. Wenn Du eine Benutzer- oder Organisations-Website erstellst, musst Du den Quellcode Deiner Website im
master-Branch speichern. Weitere Informationen findest Du unter „Über GitHub Pages." -
Wenn Ihre ausgewählte Veröffentlichungsquelle bereits vorhanden ist, navigieren Sie zu dieser Quelle. Wenn Ihre ausgewählte Veröffentlichungsquelle nicht vorhanden ist, erstellen Sie die Veröffentlichungsquelle.
-
Erstellen Sie im Root der Veröffentlichungsquelle eine neue Datei mit dem Namen
index.md, die den Inhalt enthält, der auf der Hauptseite Ihrer Website angezeigt werden soll. -
Wenn Du eine nicht standardmäßige Veröffentlichungsquelle für eine Projektwebsite verwendest, konfiguriere Deine Veröffentlichungsquelle. Weitere Informationen findest Du unter „Eine Veröffentlichungsquelle für Deine GitHub Pages-Website konfigurieren.“
-
Klicke unter Deinem Repository-Namen auf Settings (Einstellungen).
-
Um Deine veröffentlichte Website anzuzeigen, klicke unter „GitHub Pages" auf die URL Deiner Website.
Hinweis: Es kann bis zu 20 Minuten dauern, bis die Änderungen auf Deiner Website veröffentlicht werden, nachdem Du die Änderungen zu GitHub Enterprise übertragen hast. Wenn Deine Änderungen nach einer Stunde in Deinem Browser nicht angezeigt werden, findest Du weitere Informationen unter „Über Jekyll-Build-Fehler für GitHub Pages-Websites."
Hinweis: Wenn sich Deine Website-Quelldateien in der Standard-Veröffentlichungsquelle befinden —master für Benutzer- und Organisations-Webseiten oder gh-pages für Projektwebseiten—, aber Deine Website nicht automatisch veröffentlicht hat, dann stelle sicher, dass jemand mit Administratorberechtigungen und einer verifizierten E-Mail-Adresse auf die Standard-Veröffentlichungsquelle übertragen hat.
Nächste Schritte:
Sie können Ihrer Website weitere Seiten hinzufügen, indem Sie zusätzliche neue Dateien erstellen. Jede Datei wird auf Ihrer Website im selben Verzeichnis verfügbar sein wie Ihre Veröffentlichungsquelle. Wenn beispielsweise die Veröffentlichungsquelle für Ihre Projekt-Website der Branch gh-pages ist und Sie eine neue Datei mit dem Namen /about/contact-us.md auf dem Branch gh-pages erstellen, ist die Datei unter http(s)://<hostname>/pages/<username>/<repository>/about/contact-us.md verfügbar.
Sie können auch ein Design hinzufügen, um das Aussehen der Website anzupassen. Weitere Informationen finden Sie unter „Ein Design zu Ihrer GitHub Pages-Website mit Jekyll hinzufügen“.
Um Ihre Website noch weiter anzupassen, können Sie Jekyll verwenden, einen Generator für statische Websites mit integrierter Unterstützung von GitHub Pages. Weitere Informationen finden Sie unter „Informationen zu GitHub Pages und Jekyll“.