GitHub Pages-Website lokal mit Jekyll testen

Inhalt dieses Artikels

• Voraussetzungen
• Website lokal erstellen
• Das GitHub Pages-Gem aktualisieren
• Weiterführende Informationen

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. To install Bundler:

1. Install Ruby. For more information, see "Installing Ruby" in the Ruby documentation.
2. Installieren Sie Bundler. For more information, see "Bundler."

Website lokal erstellen

1. Open TerminalTerminalGit Bash.

2. Navigate to the publishing source for your site. Weitere Informationen zu Veröffentlichungsquellen finden Sie 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. Open 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