Skip to main content

GitHub Pages-Website lokal mit Jekyll testen

Du kannst deine GitHub Pages-Website lokal erstellen, um Änderungen an deiner Website vorab anzuzeigen und zu testen.

Wer kann dieses Feature verwenden?

GitHub Pages ist in öffentlichen Repositorys mit GitHub Free und GitHub Free für Organisationen sowie in öffentlichen und privaten Repositorys mit GitHub Pro, GitHub Team, GitHub Enterprise Cloud und GitHub Enterprise Server verfügbar. Weitere Informationen findest du unter GitHub-Pläne.

Platform navigation

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:

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.

Tipp: Wenn bei dem Versuch, Jekyll mithilfe von Bundler zu installieren, ein Ruby-Fehler angezeigt wird, musst du möglicherweise einen Paket-Manager wie RVM oder Homebrew verwenden, um deine Ruby-Installation zu verwalten. Weitere Informationen findest du in der Jekyll-Dokumentation unter Problembehandlung.

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