GitHub Pages-Website lokal mit Jekyll testen

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

Voraussetzungen

Bevor Sie mit Jekyll eine Website testen können, müssen folgende Voraussetzungen erfüllt sein:

• Installieren Sie Jekyll.
• Erstellen Sie eine Jekyll-Website. Weitere Informationen finden Sie 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. Führen Sie Ihre 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.

4. Öffnen Sie eine Vorschau der Website im Webbrowser. Navigieren Sie 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. Damit dieser Fall nicht eintritt, aktualisieren Sie das github-pages-Gem auf dem Computer in regelmäßigen Abständen.

1. Öffne TerminalTerminalGit Bash.
2. Aktualisieren Sie das github-pages-Gem.
   • Wenn Bundler installiert ist, führen Sie bundle update github-pages aus.
   • Wenn Sie Bundler nicht installiert haben, führen Sie gem update github-pages aus.

Weiterführende Informationen

• GitHub Pages in der Jekyll-Dokumentation