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.
   

   Hinweis: Wenn du Ruby 3.0 oder höher installiert hast (möglicherweise hast du die Standardversion über Homebrew installiert), erhältst du möglicherweise in diesem Schritt eine Fehlermeldung. 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.

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 Server. 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