Skip to main content

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

Wenn beim Erstellen deiner GitHub Pages-Website (lokal oder auf GitHub Enterprise Server) mit Jekyll ein Fehler auftritt, erhältst du eine Fehlermeldung mit weiteren Informationen.

Wer kann dieses Feature verwenden?

GitHub Pages ist in öffentlichen Repositorys mit GitHub Free und GitHub Free für Organisationen sowie in öffentlichen und privaten Repositorys mit GitHub Pro, GitHub Team, GitHub Enterprise Cloud und GitHub Enterprise Server verfügbar.

Informationen zu Jekyll-Build-Fehlern

Wenn die Veröffentlichung aus einem Branch erfolgt, wird manchmal von GitHub Pages versucht, deine Website zu erstellen, nachdem du Änderungen an die Veröffentlichungsquelle deiner Website gepusht hast.

  • Du führst den Push mit einem Deployment-Schlüssel durch. Wenn du das Pushen an das Repository deiner Website automatisieren möchtest, kannst du stattdessen einen Computerbenutzerin einrichten. Weitere Informationen findest du unter Verwalten von Bereitstellungsschlüsseln.
  • Du verwendest einen CI-Dienst, der nicht zum Erstellen deiner Veröffentlichungsquelle konfiguriert ist. Beispielsweise erstellt Travis CI den gh-pages-Branch nicht, bis du den Branch zur Liste sicherer Branches hinzufügst. Weitere Informationen zu Travis CI findest du unter Anpassen des Builds oder in der Dokumentation deines CI-Diensts.

Hinweis: Nach dem Pushen der Änderung an GitHub Enterprise Server kann es bis zu 10 Minuten dauern, bis die Änderungen an deiner Website veröffentlicht werden.

Wenn bei dem Versuch von Jekyll, deine Website zu erstellen, ein Fehler auftritt, wird eine Buildfehlermeldung angezeigt. Es gibt zwei Hauptarten an Jekyll-Build-Fehlermeldungen.

  • Die Meldung „Page build warning“ (Seitenbuildwarnung) bedeutet, dass deine Website erfolgreich erstellt wurde, du aber Änderungen vornehmen musst, um künftige Probleme zu verhindern.
  • Die Meldung „Page build failed“ (Seitenbuild fehlgeschlagen) bedeutet, dass dein Build nicht abgeschlossen werden konnte. Wenn Jekyll einen Grund dafür erkennt, enthält die Fehlermeldung eine Beschreibung der Ursache.

Weitere Informationen zur Problembehandlung bei Buildfehlern findest du unter Fehlerbehebung bei Jekyll-Build-Fehlern für GitHub Pages-Websites.

Anzeigen der Buildfehler deines Repositorys auf GitHub Enterprise Server

Du kannst Buildfehler (aber keine Buildwarnungen) für deine Website auf GitHub Enterprise Server auf der Registerkarte Einstellungen im Repository deiner Website anzeigen.

Lokales Anzeigen von Jekyll-Buildfehlermeldungen

Wir empfehlen dir, deine Website lokal zu testen. Dadurch siehst du Build-Fehlermeldungen in der Befehlszeile und kannst Build-Fehler beheben, bevor du die Änderungen zu GitHub Enterprise Server pushst. Weitere Informationen findest du unter GitHub Pages-Website lokal mit Jekyll testen.

Anzeigen von Jekyll-Buildfehlermeldungen in deinem Pull Request

Wenn die Veröffentlichung aus einem Branch erfolgt und du du einen Pull Request erstellst, um deine Veröffentlichungsquelle auf GitHub Enterprise Server zu aktualisieren, kannst du Fehlermeldungen auf der Registerkarte Überprüfungen des Pull Requests anzeigen. Weitere Informationen findest du unter Informationen zu Statuschecks.

Wenn du für die Veröffentlichung einen benutzerdefinierten GitHub Actions-Workflow verwendest, musst du den Workflow so konfigurieren, dass er beim pull_request-Trigger ausgeführt wird, um Buildfehlermeldungen in deinem Pull Request anzeigen zu können. In diesem Fall wird empfohlen, alle Bereitstellungsschritte zu überspringen, wenn der Workflow vom pull_request-Ereignis ausgelöst wurde. Auf diese Weise kannst du Buildfehler anzeigen, ohne die Änderungen aus deinem Pull Request auf deiner Website bereitzustellen. Weitere Informationen findest du unter Ereignisse zum Auslösen von Workflows und Ausdrücke.

Anzeigen von Jekyll-Buildfehlern per E-Mail

Wenn die Veröffentlichung aus einem Branch erfolgt und du Änderungen an deine Veröffentlichungsquelle auf GitHub Enterprise Server pushst, versucht GitHub Pages, deine Website zu erstellen. Wenn der Build fehlschlägt, wird eine E-Mail an deine primäre E-Mail-Adresse gesendet.

Du erhältst nur dann eine E-Mail, wenn die Unterstützung für ausgehende E-Mails auf Ihre GitHub Enterprise Server-Instance aktiviert ist. Für weitere Informationen kontaktiere deinen Websiteadministrator.

Wenn du für die Veröffentlichung einen benutzerdefinierten GitHub Actions-Workflow verwendest, musst du den Workflow so konfigurieren, dass er beim pull_request-Trigger ausgeführt wird, um E-Mails über Buildfehler in deinem Pull Request anzeigen zu können. In diesem Fall wird empfohlen, alle Bereitstellungsschritte zu überspringen, wenn der Workflow vom pull_request-Ereignis ausgelöst wurde. Auf diese Weise kannst du Buildfehler anzeigen, ohne die Änderungen aus deinem Pull Request auf deiner Website bereitzustellen. Weitere Informationen findest du unter Ereignisse zum Auslösen von Workflows und Ausdrücke.

Anzeigen von Jekyll-Buildfehlermeldungen in deinem Pull Request mit einem CI-Drittanbieterdienst

Du kannst einen Drittanbieterdienst wie Travis CI so konfigurieren, dass nach jedem Commit Fehlermeldungen angezeigt werden.

  1. Füge eine Datei namens _Gemfile_zum Stamm deiner Veröffentlichungsquelle mit den folgenden Inhalten hinzu (falls diese noch nicht vorhanden ist):

    source `https://rubygems.org`
    gem `github-pages`
    
  2. Konfiguriere das Repository deiner Website für den gewünschten Testdienst. Um beispielsweise Travis CI zu verwenden, füge eine Datei namens .travis.yml zum Stamm deiner Veröffentlichungsquelle mit den folgenden Inhalten hinzu:

    language: ruby
    rvm:
      - 2.3
    script: "bundle exec jekyll build"
    
  3. Du musst dein Repository eventuell mit dem Drittanbieter-Testdienst aktivieren. Weitere Informationen findest du in der Dokumentation deines Testdiensts.