GitHub Pages-Website lokal mit Jekyll testen

Personen mit Schreibberechtigungen für ein Repository können eine GitHub Pages-Website lokal testen.

Voraussetzungen

Bevor du mit Jekyll eine Website testen kannst, müssen folgende Voraussetzungen erfüllt sein:

• Jekyll installiert.
• Erstelle eine Jekyll-Website. Weitere Informationen findest du unter GitHub Pages-Website mit Jekyll erstellen.

Es wird empfohlen, Bundler zum Installieren und Ausführen von Jekyll zu verwenden. Bundler verwaltet „Ruby gem"-Abhängigkeiten, reduziert Jekyll-Build-Fehler und verhindert umgebungsspezifische Bugs. Um Bundler zu installieren:

1. Ruby installieren. Weitere Informationen findest du unter Installieren von Ruby in der Ruby-Dokumentation.
2. Installiere Bundler. Weitere Informationen findest du unter Bundler.

Website lokal erstellen

1. Öffne TerminalTerminalGit Bash.

2. Navigiere zur Veröffentlichungsquelle für deine Website. Weitere Informationen findest du unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren.

3. Führe aus bundle install.

4. Führe dein Jekyll-Website lokal aus.

   $ bundle exec jekyll serve
   > Configuration file: /Users/octocat/my-site/_config.yml
   >            Source: /Users/octocat/my-site
   >       Destination: /Users/octocat/my-site/_site
   > Incremental build: disabled. Enable with --incremental
   >      Generating...
   >                    done in 0.309 seconds.
   > Auto-regeneration: enabled for '/Users/octocat/my-site'
   > Configuration file: /Users/octocat/my-site/_config.yml
   >    Server address: http://127.0.0.1:4000/
   >  Server running... press ctrl-c to stop.
   

   Hinweise:

   • Wenn Sie Ruby 3.0 oder höher installiert haben (was der Fall sein kann, wenn Sie die Standardversion über Homebrew installiert haben), wird in diesem Schritt unter Umständen eine Fehlermeldung angezeigt. Das liegt daran, dass diese Versionen von Ruby nicht mehr mit webrick installiert werden.

     Um den Fehler zu beheben, versuche bundle add webrick auszuführen, und führe dann erneut bundle exec jekyll serve aus.

   • Wenn das Feld baseurl der Datei _config.yml den Link Ihres GitHub-Repositorys enthält, können Sie beim lokalen Erstellen den folgenden Befehl verwenden, um den betreffenden Wert zu ignorieren und die Site unter localhost:4000/ zu bedienen:

     bundle exec jekyll serve --baseurl=""
     

5. Navigiere zum Anzeigen deiner Website in deinem Webbrowser zu http://localhost:4000.

Das GitHub Pages-Gem aktualisieren

Jekyll ist ein aktives Open-Source-Projekt, das regelmäßig aktualisiert wird. Wenn das Gem github-pages auf deinem Computer älter ist als das Gem github-pages auf dem GitHub Pages-Server, sieht deine Website beim lokalen Build möglicherweise anders aus als bei Veröffentlichung in GitHub Enterprise Cloud. Um dies zu vermeiden, aktualisiere das Gem github-pages auf deinem Computer regelmäßig.

1. Öffne TerminalTerminalGit Bash.
2. Aktualisiere das Gem github-pages.
   • Wenn du Bundler installiert hast, führe bundle update github-pages aus.
   • Wenn Bundler nicht installiert ist, führe gem update github-pages aus.

Weiterführende Themen

• GitHub Pages in der Dokumentation zu Jekyll