Fehlerbehebung bei Jekyll-Build-Fehlern für GitHub Pages-Websites

Fehlerbehebung bei Build-Fehlern

Wenn beim Erstellen Ihrer GitHub Pages-Website (lokal oder auf GitHub Enterprise) mit Jekyll ein Fehler auftritt, können Sie die Fehlerbehebung mithilfe der Fehlermeldungen durchführen. Weitere Informationen zu Fehlermeldungen und zum Abrufen dieser Meldungen finden Sie unter „Behebung von Jekyll-Build-Fehlern bei GitHub Pages-Websites“.

Wenn Sie eine generische Fehlermeldung erhalten haben, suchen Sie nach häufigen Fehlern.

• Sie verwenden nicht unterstützte Plugins. Weitere Informationen finden Sie unter „Informationen zu GitHub Pages und Jekyll“.
• Sie haben die source-Einstellung in der Datei _config.yml geändert. GitHub Pages überschreibt diese Einstellung beim Build-Prozess.
• Ein Dateiname in Ihrer Veröffentlichungsquelle enthält einen Doppelpunkt (:). Dies wird nicht unterstützt.

Wenn Sie eine spezifische Fehlermeldung erhalten haben, lesen Sie die nachfolgenden Informationen zur Fehlerbehebung für die jeweilige Fehlermeldung.

Wenn Sie einen Fehler behoben haben, übertragen Sie die Änderungen mit einem Push-Vorgang an die Veröffentlichungsquelle der Website, sodass ein neuer Build auf GitHub Enterprise ausgelöst wird.

Fehler bei der Dateikonfiguration

Dieser Fehler bedeutet, dass der Build Ihrer Website fehlgeschlagen ist, da die Datei _config.yml Syntaxfehler enthält.

Zur Fehlerbehebung prüfen Sie, ob die Datei _config.yml diesen Regeln entspricht:

• Verwende Leerzeichen statt Tabs.
• Füge für jedes Schlüsselwertpaar ein Leerzeichen nach dem : ein, beispielsweise timezone: Africa/Nairobi.
• Verwende nur UTF-8-Zeichen.
• Setze alle Sonderzeichen wie zum Beispiel : in Anführungszeichen, beispielsweise title: "my awesome site: an adventure in parse errors".
• Für mehrzeilige Werte verwende | um Zeilenumbrüche zu erstellen und > um Zeilenumbrüche zu ignorieren.

Um Fehler zu identifizieren, kannst Du den Inhalt Deiner YAML-Datei kopieren und in einen YAML-Linter einfügen, beispielsweise YAML Validator.

Datum besitzt ungültiges Datum/Uhrzeit

Dieser Fehler bedeutet, dass eine Seite der Website einen ungültigen Wert für Datum/Uhrzeit enthält.

Zur Fehlerbehebung prüfen Sie die in der Fehlermeldung genannte Datei und deren Layouts auf Aufrufe datumsbezogener Liquid-Filter. Prüfen Sie, ob alle Variablen, die an datumsabhängige Liquid-Filter übergeben werden, Werte enthalten und nicht nil oder "" übergeben. Weitere Informationen finden Sie unter „Liquid filters“ (Liquid-Filter) in der Liquid-Dokumentation.

Datei ist im Verzeichnis „includes“ nicht vorhanden

Dieser Fehler bedeutet, dass Ihr Code auf eine Datei verweist, die sich nicht im Verzeichnis _includes befindet.

Zur Fehlerbehebung durchsuche die Datei in der Fehlermeldung auf include um zu sehen, wo Du auf andere Dateien verwiesen hast, wie beispielsweise {% include example_header.html %}. Wenn sich referenzierte Dateien nicht im Verzeichnis _includes befinden, kopieren oder verschieben Sie die betreffenden Dateien in das Verzeichnis _includes.

Datei ist ein Symlink

Dieser Fehler bedeutet, dass der Code auf eine per Symlink verlinkte Datei verweist, die sich nicht in der Veröffentlichungsquelle für die Website befindet.

Zur Fehlerbehebung durchsuche die Datei in der Fehlermeldung auf include um zu sehen, wo Du auf andere Dateien verwiesen hast, wie beispielsweise {% include example_header.html %}. Wenn per Symlink verlinkte Dateien referenziert werden, kopieren oder verschieben Sie die betreffenden Dateien in das Verzeichnis _includes.

Datei ist nicht ordnungsgemäß UTF-8-codiert

Dieser Fehler bedeutet, dass Sie nicht lateinische Buchstaben wie 日本語 verwendet haben, ohne dem Computer mitzuteilen, dass er diese Symbole erwarten soll.

Zur Fehlerbehebung erzwingen Sie die UTF-8-Codierung. Tragen Sie hierzu die folgende Zeile in die Datei _config.yml ein:

encoding: UTF-8

Textmarkersprache ungültig

Dieser Fehler bedeutet, dass Sie nicht den Syntaxmarkierer Rouge oder Pygments in der Konfigurationsdatei angegeben haben. sondern einen anderen Markierer.

Zur Fehlerbehebung aktualisieren Sie die Datei _config.yml, und geben Sie Rouge oder Pygments an. Weitere Informationen finden Sie unter „Informationen zu GitHub Enterprise und Jekyll“.

Ungültiges Beitragsdatum

Dieser Fehler bedeutet, dass ein Beitrag auf Ihrer Website ein ungültiges Datum im Dateinamen oder in der YAML-Frontmatter enthält.

Zur Fehlerbehebung formatieren Sie alle Datumsangaben als JJJ-MM-TT HH:MM:SS für UTC, und prüfen Sie, ob gültige Kalenderdaten angegeben sind. Soll eine Zeitzone außerhalb der UTC angegeben werden, verwenden Sie das Format JJJJ-MM-TT HH:MM:SS +/-TTTT, z. B. 2014-04-18 11:30:00 +0800.

Wenn Sie ein Datumsformat in der Datei _config.yml festlegen, achten Sie auf das richtige Format.

Sass oder SCSS ungültig

Dieser Fehler bedeutet, dass Ihr Repository eine Sass- oder SCSS-Datei mit ungültigem Inhalt enthält.

Zur Fehlerbehebung prüfen Sie die in der Fehlermeldung genannte Zeilennummer auf ungültige Sass- oder SCSS. Damit solche Fehler in Zukunft vermieden werden, installieren Sie einen Sass- oder SCSS-Linter für Ihren meistgenutzten Texteditor.

Ungültiges Submodul

Dieser Fehler bedeutet, dass Ihr Repository ein nicht ordnungsgemäß initialisiertes Submodul enthält.

Zur Fehlerbehebung entscheide zuerst, ob Du tatsächlich ein Submodul verwenden möchtest, bei dem es sich um ein Git-Projekt innerhalb eines Git-Projekts handelt; Submodule werden manchmal versehentlich erstellt.

Wenn Du kein Submodul verwenden möchtest, entferne das Submodul und ersetze PATH-TO-SUBMODULE mit dem Pfad zum Submodul:

$ git submodule deinit PATH-TO-SUBMODULE
$ git rm PATH-TO-SUBMODULE
$ git commit -m "Remove submodule"
$ rm -rf .git/modules/PATH-TO-SUBMODULE

Soll das Submodul dennoch verwendet werden, referenzieren Sie das Submodul mit https:// (nicht mit http://), und das Submodul muss sich in einem öffentlichen Repository befinden.

Ungültige YAML in der Datendatei

Dieser Fehler bedeutet, dass mindestens eine Datei im Ordner _data ungültige YAML enthält.

Zur Fehlerbehebung prüfen Sie, ob die YAML-Dateien im Ordner _data diesen Regeln entsprechen:

• Verwende Leerzeichen statt Tabs.
• Füge für jedes Schlüsselwertpaar ein Leerzeichen nach dem : ein, beispielsweise timezone: Africa/Nairobi.
• Verwende nur UTF-8-Zeichen.
• Setze alle Sonderzeichen wie zum Beispiel : in Anführungszeichen, beispielsweise title: "my awesome site: an adventure in parse errors".
• Für mehrzeilige Werte verwende | um Zeilenumbrüche zu erstellen und > um Zeilenumbrüche zu ignorieren.

Um Fehler zu identifizieren, kannst Du den Inhalt Deiner YAML-Datei kopieren und in einen YAML-Linter einfügen, beispielsweise YAML Validator.

Weitere Informationen zu Jekyll-Datendateien finden Sie unter „Data Files“ (Datendateien) in der Jekyll-Dokumentation.

Markdown-Fehler

Dieser Fehler bedeutet, dass Ihr Repository Markdown-Fehler enthält.

Zur Fehlerbehebung verwenden Sie einen unterstützten Markdown-Prozessor. Weitere Informationen finden Sie unter „Markdown-Prozessor für Ihre GitHub Pages-Website mit Jekyll festlegen“.

Prüfen Sie außerdem, ob die in der Fehlermeldung genannte Datei eine gültige Markdown-Syntax umfasst. Weitere Informationen finden Sie unter „Markdown: Syntax“ bei Daring Fireball.

Dokumentordner fehlt

Dieser Fehler bedeutet, dass Sie den Ordner docs als Veröffentlichungsquelle ausgewählt haben, jedoch kein Ordner docs im Stammverzeichnis des Repositorys auf dem master-branch vorliegt.

Wenn der Ordner /docs unabsichtlich verschoben wurde, verschieben Sie ihn zur Fehlerbehebung wieder zum Root des Repositorys auf dem master-Branch. Wenn der Ordner docs versehentlich gelöscht wurde, können Sie wie folgt vorgehen:

• Machen Sie den Löschvorgang mit Git rückgängig. Weitere Informationen finden Sie unter „git-revert in der Git-Dokumentation.
• Erstellen Sie einen neuen Ordner docs im Stammverzeichnis des Repositorys auf dem master-Branch, und fügen Sie die Quelldateien Ihrer Website in den Ordner ein. Weitere Informationen finden Sie unter „Neue Dateien erstellen“.
• Ändern Sie die Veröffentlichungsquelle. Weitere Informationen finden Sie unter „Eine Veröffentlichungsquelle für GitHub Pages konfigurieren“.

Submodul fehlt

Dieser Fehler bedeutet, dass Ihr Repository ein nicht vorhandenes oder ein nicht ordnungsgemäß initialisiertes Submodul enthält.

Zur Fehlerbehebung entscheide zuerst, ob Du tatsächlich ein Submodul verwenden möchtest, bei dem es sich um ein Git-Projekt innerhalb eines Git-Projekts handelt; Submodule werden manchmal versehentlich erstellt.

Wenn Du kein Submodul verwenden möchtest, entferne das Submodul und ersetze PATH-TO-SUBMODULE mit dem Pfad zum Submodul:

$ git submodule deinit PATH-TO-SUBMODULE
$ git rm PATH-TO-SUBMODULE
$ git commit -m "Remove submodule"
$ rm -rf .git/modules/PATH-TO-SUBMODULE

Soll ein Submodul verwendet werden, initialisieren Sie das Submodul. Weitere Informationen finden Sie unter „Git-Tools – Submodule“ im Pro Git-Buch.

Relative Permalinks konfiguriert

Dieser Fehler bedeutet, dass Sie relative Permalinks in der Datei _config.yml nutzen, die nicht von GitHub Pages unterstützt werden.

Permalinks sind permanente URLs, die auf einen bestimmten Beitrag oder eine bestimmte Seite Ihrer Website verweisen. Absolute Permalinks beginnen mit dem Root der Website, relative Permalinks dagegen mit dem Ordner, in dem sich die referenzierte Seite befindet. GitHub Pages und Jekyll unterstützen relative Permalinks nicht mehr. Weitere Informationen zu Permalink finden Sie unter „Permalinks“ in der Jekyll-Dokumentation.

Zur Fehlerbehebung entfernen Sie die Konfigurationsoption relative_permalinks aus der Datei _config.yml der Website, und ändern Sie alle relativen Permalinks auf der Website in absolute Permalinks. Weitere Informationen finden Sie unter „Dateien in Ihrem Repository bearbeiten“.

Symlink ist im Repository Ihrer Website nicht vorhanden

Dieser Fehler bedeutet, dass die Website einen symbolischen Link (Symlink) enthält, der sich nicht in der Veröffentlichungsquelle für die Website befindet. Weitere Informationen zu Symlinks finden Sie unter „Symbolic Link“ (Symbolische Verknüpfung) auf Wikipedia.

Zur Fehlerbehebung prüfen Sie, ob die in der Fehlermeldung genannte Datei für den Build der Website erforderlich ist. Falls nicht (oder falls die Datei kein Symlink sein soll), löschen Sie die Datei. Wenn die Datei, auf die der Symlink verweist, für den Build der Website erforderlich ist, stellen Sie sicher, dass die Datei oder das Verzeichnis, auf das der Symlink verweist, in der Veröffentlichungsquelle der Wbsite vorhanden ist. Um externe Assets einzuschließen, empfiehlt es sich, einen Drittanbieter-Paketmanager wie Bower zu verwenden.

Syntaxfehler in der „for“-Schleife

Dieser Fehler bedeutet, dass Ihr Code ungültige Syntax in einer Liquid-for-Schleifen-Deklaration enthält.

Zur Fehlerbehebung prüfen Sie die Syntax in allen for-Schleifen in der Datei, die in der Fehlermeldung genannt ist. Weitere Informationen zur korrekten Syntax für for-Schleifen finden Sie unter „Iteration tags“ (Iterations-Tags) in der Liquid-Dokumentation.

Tag nicht ordnungsgemäß geschlossen

Diese Fehlermeldung bedeutet, dass Ihr Code ein logisches Tag enthält, das nicht korrekt geschlossen ist. {% capture example_variable %} muss beispielsweise mit {% endcapture %} geschlossen werden.

Zur Fehlerbehebung prüfen Sie, ob alle logischen Tags in der Datei, die in der Fehlermeldung genannt ist, ordnungsgemäß geschlossen sind. Weitere Informationen finden Sie unter „Liquid tags“ (Liquid-Tags) in der Liquid-Dokumentation.

Tag nicht ordnungsgemäß beendet

Diese Fehlermeldung bedeutet, dass Ihr Code ein Ausgabe-Tag enthält, das nicht korrekt beendet wurde. Beispiel: {{ page.title } statt {{ page.title }}.

Zur Fehlerbehebung prüfen Sie, ob alle Ausgabe-Tags in der Datei, die in der Fehlermeldung genannt ist, mit }} beendet wurden. Weitere Informationen finden Sie unter „Liquid objects“ (Liquid-Objekte) in der Liquid-Dokumentation.

Unbekannter Tag-Fehler

Dieser Fehler bedeutet, dass Ihr Code ein nicht erkanntes Liquid-Tag enthält.

Zur Fehlerbehebung prüfen Sie, ob alle Liquid-Tags in der Datei, die in der Fehlermeldung genannt ist, den Jekyll-Standardvariablen entsprechen und ob die Tag-Namen korrekt geschrieben sind. Eine Liste der Standardvariablen finden Sie unter „Variables“ (Variablen) in der Jekyll-Dokumentation.

Nicht unterstützte Plug-ins sind häufig die Quelle für unbekannte Tags. Wenn Sie ein nicht unterstütztes Plug-in auf der Website verwenden, also die Website lokal erstellen und die statischen Dateien per Push-Verfahren an GitHub Enterprise übertragen, darf das Plug-in keine Tags umfassen, die nicht in den Jekyll-Standardvariablen aufgeführt sind. Eine Liste der unterstützten Plug-ins finden Sie unter „Informationen zu GitHub Pages und Jekyll“.