GitHub Pages-Website lokal mit Jekyll testen

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

Vorrausetzungen

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

• Installiere Jekyll.
• Erstelle eine Jekyll-Website. Weitere Informationen findest Du unter „Eine GitHub Pages-Website mit Jekyll erstellen.“

Zur Installation und Ausführung von Jekyll empfehlen wir Bundler. Bundler verwaltet „Ruby gem"-Abhängigkeiten, reduziert Jekyll-Build-Fehler und verhindert umgebungsspezifische Bugs. Um Bundler zu installieren:

1. Installiere Ruby. Weitere Informationen findest Du unter „Installieren von Ruby" in der Ruby-Dokumentation.
2. Installieren Sie 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 zu Veröffentlichungsquellen findest Du unter „Informationen zu GitHub Pages.“
3. Run 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.

5. Öffne eine Vorschau der Website im Webbrowser. Navigiere hierzu zu http://localhost:4000.

Das GitHub Pages-Gem aktualisieren

Jekyll ist ein aktives Open-Source-Projekt, das regelmäßig aktualisiert wird. Wenn das github-pages-Gem auf dem Computer älter ist als das github-pages-Gem auf dem GitHub Pages-Server, wird die lokal erstellte Website unter Umständen anders dargestellt als bei der tatsächlichen Veröffentlichung auf GitHub Enterprise Server. Damit dieser Fall nicht eintritt, aktualisiere das github-pages-Gem auf dem Computer in regelmäßigen Abständen.

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

Weiterführende Informationen

• GitHub Pages in der Jekyll-Dokumentation