Informationen zu Jekyll-Build-Fehler für GitHub Pages-Websites
Wenn beim Erstellen Ihrer GitHub Pages-Website (lokal oder auf GitHub Enterprise) mit Jekyll ein Fehler auftritt, erhalten Sie eine Fehlermeldung mit weiteren Informationen.
GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.
Inhalt dieses Artikels
Informationen zu Jekyll-Build-Fehlern
Manchmal kann es vorkommen, dass GitHub Pages nicht versucht, Ihre Website zu erstellen, nachdem Sie Änderungen zur Veröffentlichungsquelle Ihrer Website gepusht haben.
- Sie führen den Push mit einem Deployment-Schlüssel durch. Wenn Sie Pushes zum Repository Ihrer Website automatisieren möchten, können Sie stattdessen einen Maschinenbenutzer einrichten. Weitere Informationen finden Sie unter „Deployment-Schlüssel verwenden“ in der die GitHub-Entwicklerdokumentation.
- Sie verwenden einen Dienst für die fortlaufende Integration, der nicht zum Erstellen Ihrer Veröffentlichungsquelle konfiguriert ist. Travis CI erstellt beispielsweise nicht den Branch
gh-pages, es sei denn, Sie fügen den Branch zu einer Liste mit sicheren Branches hinzu. Weitere Informationen finden Sie unter „Build anpassen“ auf Travis CI oder in der Dokumentation Ihres Dienstes für die fortlaufende Integration.
Hinweis: Es kann bis zu 20 Minuten dauern, bis die Änderungen auf Ihrer Website veröffentlicht werden, nachdem Sie die Änderungen zu GitHub Enterprise gepusht haben.
Wenn beim Versuch von Jekyll, Ihre Website zu erstellen, ein Fehler auftritt, wird eine Build-Fehlermeldung angezeigt. Es gibt zwei Hauptarten an Jekyll-Build-Fehlermeldungen.
- Eine „Page-Build-Warnung“ (Seiten-Build-Warnung) bedeutet, dass Ihre Website erfolgreich erstellt wurde, Sie aber Änderungen vornehmen müssen, um zukünftige Probleme zu verhindern.
- Eine Fehlermeldung „Page build failed“ (Seiten-Build fehlgeschlagen) bedeutet, dass Ihr Build nicht abgeschlossen werden konnte. Wenn Jekyll einen Grund dafür erkennt, enthält die Fehlermeldung eine Beschreibung der Ursache.
Weitere Informationen zur Behebung von Build-Fehlern finden Sie unter „Behebung von Jekyll-Build-Fehlern bei GitHub Pages-Websites“.
Jekyll-Build-Fehlermeldungen anzeigen
Wir empfehlen Ihnen, Ihre Website lokal zu testen. Dadurch sehen Sie Build-Fehlermeldungen in der Befehlszeile und können Build-Fehler beheben, bevor Sie die Änderungen zu GitHub Enterprise pushen. Weitere Informationen finden Sie unter „GitHub Pages-Website lokal mit Jekyll testen“.
Wenn Sie Änderungen zu Ihrer Veröffentlichungsquelle auf GitHub Enterprise pushen, versucht GitHub Pages, Ihre Website zu erstellen. Wenn der Build fehlschlägt, wird eine E-Mail an Ihre primäre E-Mail-Adresse gesendet. Sie erhalten auch bei Build-Warnungen E-Mails-Benachrichtigungen.
You will only receive an email if outbound email support is enabled on Ihre GitHub Enterprise Server-Instanz. For more information, contact your site administrator.
Build-Fehler (aber keine Build-Warnungen) für Ihre Website können Sie auf GitHub Enterprise auf der Registerkarte Settings (Einstellungen) des Repositorys Ihrer Website sehen.
Sie können einen Drittanbieterdienst, beispielsweise Travis CI, so konfigurieren, dass nach jedem Commit Fehlermeldungen angezeigt werden.
-
Wenn Sie dies noch nicht getan haben, fügen Sie eine Datei namens Gemfile in das Root-Verzeichnis Ihrer Veröffentlichungsquelle hinzu. Die Gemfile-Datei sollte den folgenden Inhalt aufweisen:
source `https:/rubygems.org` gem `github-pages` -
Konfigurieren Sie das Repository Ihrer Website für den gewünschten Testdienst. Wenn Sie z. B. Travis CI verwenden möchten, fügen Sie eine Datei namens .travis.yml in das Root-Verzeichnis Ihrer Veröffentlichungsquelle hinzu, und zwar mit folgendem Inhalt:
language: ruby rvm: - 2.3 script: "bundle exec jekyll build" -
Sie müssen Ihr Repository ggf. mit dem Drittanbieter-Testdienst aktivieren. Weitere Informationen finden Sie in der Dokumentation Ihres Testdienstes.