GitHub Pages-Website mit Jekyll erstellen

Voraussetzungen

Bevor du mit Jekyll eine GitHub Pages-Website erstellen kannst, musst du Jekyll und Git installieren. Weitere Informationen findest du unter Installation in der Jekyll-Dokumentation und unter Einrichten von Git.

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.

Ein Repository für eine Website erstellen

Du kannst entweder ein Repository erstellen oder ein vorhandenes Repository für deine Website auswählen.

Wenn du eine GitHub Pages-Website für ein Repository erstellen möchtest, wobei nicht alle Dateien im Repository mit der Website verknüpft sind, kannst du eine Veröffentlichungsquelle für deine Website konfigurieren. Du kannst z. B. einen dedizierten Branch und Ordner für deine Websitequelldateien einrichten oder einen benutzerdefinierten GitHub Actions-Workflow verwenden, um deine Websitequelldateien zu erstellen und zu bereitzustellen. Um GitHub Actions als Veröffentlichungsquelle für GitHub Pages zu verwenden, muss ein Siteadministrator GitHub Actions für GitHub Enterprise Server aktivieren. Weitere Informationen findest du unter Aktivieren von GitHub Actions für GitHub Enterprise Server.

Wenn du eine Website in einem vorhandenen Repository erstellen möchtest, fahre mit dem Abschnitt Erstellen deiner Website fort.

1. Wähle in der rechten oberen Ecke einer beliebigen Seite , und klicke dann auf Neues Repository.

   

2. Verwende das Dropdownmenü Besitzer, um das Besitzerkonto für das Repository auszuwählen.

   

3. Gib einen Namen sowie eine optionale Beschreibung für Dein Repository ein. Wenn du eine Benutzer- oder Organisationswebsite erstellst, muss dein Repository <user>.github.io oder <organization>.github.io heißen. Wenn dein Benutzer- oder Organisationsname Großbuchstaben enthält, musst du diese als Kleinbuchstaben schreiben. Weitere Informationen findest du unter Informationen zu GitHub Pages.

   

4. Wähle eine Sichtbarkeitsoption für das Repository aus. Weitere Informationen findest du unter Informationen zu Repositorys.

Eine Website erstellen

Bevor du deine Website erstellen kannst, musst du ein Repository für deine Website auf GitHub Enterprise Server haben. Wenn du deine Website nicht in einem vorhandenen Repository erstellst, lies Erstellen eines Repositorys für deine Website.

1. Öffne TerminalTerminalGit Bash.

2. Wenn du noch keine lokale Kopie deines Repositorys besitzt, navigiere zu dem Speicherort, an dem du die Quelldateien deiner Website speichern möchtest, und ersetze dabei PARENT-ORDNER durch den Ordner, der den Ordner für dein Repository enthalten soll.

   cd PARENT-FOLDER
   

3. Wenn du dies noch nicht getan hast, initialisiere ein lokales Git-Repository und ersetzen dabei REPOSITORY-NAME durch den Namen deines Repositorys.

   $ git init REPOSITORY-NAME
   > Initialized empty Git repository in /REPOSITORY-NAME/.git/
   # Creates a new folder on your computer, initialized as a Git repository
   

4. Wechsle in das Verzeichnis des Repositorys.

   $ cd REPOSITORY-NAME
   # Changes the working directory
   

5. Entscheide, welche Veröffentlichungsquelle du verwenden möchtest. Weitere Informationen findest du unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren.

6. Navigiere zur Veröffentlichungsquelle für deine Website. Weitere Informationen findest du unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren. Wenn du dich beispielsweise entschieden hast, deine Website aus dem docs-Ordner in der Standardverzweigung zu veröffentlichen, erstellen und verschiebe Verzeichnisse in den docs-Ordner.

   $ mkdir docs
   # Creates a new folder called docs
   $ cd docs
   

   If you chose to publish your site from the gh-pages branch, create and checkout the gh-pages branch.

   $ git checkout --orphan gh-pages
   # Creates a new branch, with no history or contents, called gh-pages, and switches to the gh-pages branch
   $ git rm -rf .
   # Removes the contents from your default branch from the working directory
   

7. Verwende den jekyll new-Befehl im Stammverzeichnis deines Repositorys, um eine neue Jekyll-Website zu erstellen:

   $ jekyll new --skip-bundle .
   # Creates a Jekyll site in the current directory
   

8. Öffne die Gemfile, die Jekyll erstellt hat.

9. Füge „#“ am Anfang der Zeile hinzu, die mit gem "jekyll" beginnt, um diese Zeile auszukommentieren.

10. Füge das github-pages-Gem hinzu, indem du die Zeile mit # gem "github-pages" startest. Ändere diese Zeile zu:

    gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins
    

    Ersetze GITHUB-PAGES-VERSION durch die neueste unterstützte Version des github-pages-Gems. Diese Version findest du hier: „Abhängigkeitsversionen".

    Die richtige Jekyll-Version wird als Abhängigkeit des github-pages-Gems installiert.

11. Speichere und schließe das Gemfile.

12. Führe bundle install über die Befehlszeile aus.

13. Öffnen Sie die .gitignore-Datei, die Jekyll erstellt hat, und ignorieren Sie die Sperrdatei für Edelsteine, indem Sie diese Zeile hinzufügen:

    Gemfile.lock
    

14. Nimm optional alle erforderlichen Änderungen an der _config.yml-Datei vor. Dies ist für relative Pfade erforderlich, wenn das Repository in einem Unterverzeichnis gehostet wird. Weitere Informationen findest du unter Unterordner in ein neues Repository auslagern.

    domain: my-site.github.io       # if you want to force HTTPS, specify the domain without the http at the start, e.g. example.com
    url: https://my-site.github.io  # the base hostname and protocol for your site, e.g. http://example.com
    baseurl: /REPOSITORY-NAME/      # place folder name if the site is served in a subfolder
    

15. Teste deine Website optional lokal. Weitere Informationen findest du unter Lokales Testen deiner GitHub Pages-Website mit Jekyll.

16. Füge deine Arbeit hinzu und übernimm sie.

    git add .
    git commit -m 'Initial GitHub pages site with Jekyll'
    

17. Füge dein Repository auf Ihre GitHub Enterprise Server-Instance als Remoterepository hinzu, ersetze HOSTNAME durch den Hostnamen deines Unternehmens USER durch das Konto, dem das Respository gehört, und REPOSITORY durch den Namen des Repositorys.

    
    $ git remote add origin https://HOSTNAME/USER/REPOSITORY.git
    
    

18. Übertrage das Repository zu GitHub Enterprise Server und ersetze dabei BRANCH durch den Namen des Branches, auf dem du gerade arbeitest.

    git push -u origin BRANCH
    

19. Konfiguriere deine Veröffentlichungsquelle. Weitere Informationen finden Sie unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren.

20. Navigiere in GitHub Enterprise Server zum Repository Deiner Website.

21. Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    

22. Klicke im Abschnitt „Code und Automatisierung“ der Seitenleiste auf Seiten.

23. Um deine veröffentlichte Website anzuzeigen, klicke unter „GitHub Pages“ auf Website besuchen.

    

    Note

    Es kann bis zu 10 Minuten dauern, bis die Änderungen an deiner Website veröffentlicht werden, nachdem du sie an GitHub Enterprise Server gepusht hast. Wenn deine Änderungen an der GitHub Pages-Website nach einer Stunde noch nicht in deinem Browser angezeigt werden, findest du weitere Informationen unter Informationen zu Jekyll-Build-Fehler für GitHub Pages-Websites.

Nächste Schritte

Informationen zum Hinzufügen einer neuen Seite oder eines Beitrags zu deiner Website findest du unter Inhalte zur GitHub Pages-Website mit Jekyll hinzufügen.

Du kannst zu Deiner GitHub Pages-Website ein Jekyll-Design hinzufügen, um das Erscheinungsbild Deiner Website anzupassen. Weitere Informationen findest du unter Ein Design zur GitHub Pages-Website mit Jekyll hinzufügen.