Informationen zu Jekyll-Build-Fehler für GitHub Pages-Websites

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.

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.

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.

1. 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`
   

2. 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"
   

3. Sie müssen Ihr Repository ggf. mit dem Drittanbieter-Testdienst aktivieren. Weitere Informationen finden Sie in der Dokumentation Ihres Testdienstes.