GitHub Pages-Website mit Jekyll erstellen

Hinweis: Organisationsbesitzer können die Veröffentlichung von GitHub Pages-Websites aus Repositorys im Besitz der Organisation einschränken. Weitere Informationen findest du unter Verwalten der Veröffentlichung von GitHub Pages-Websites für deine Organisation.

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

Ruby installieren. Weitere Informationen findest du unter Installieren von Ruby in der Ruby-Dokumentation.
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.

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 deine GitHub Enterprise Server-Instanz 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.

Verwende in der oberen rechten Ecke einer beliebigen Seite das -Dropdownmenü, und wähle Neues Repository aus. 1. Verwende das Dropdownmenü Besitzer, und wähle das Besitzerkonto für das Repository aus. 1. 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. 1. 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.

Warnung: Wenn dein Websiteadministrator öffentliche Seiten aktiviert hat, sind GitHub Pages-Websites im Internet öffentlich zugänglich, auch wenn das Repository für die Website privat oder intern ist. Wenn das Repository deiner Website vertrauliche Daten enthält, solltest Du diese vor der Veröffentlichung entfernen. Weitere Informationen findest du unter Konfigurieren von GitHub Seiten für dein Unternehmen und unter Informationen zu Repositorys.

Öffne TerminalTerminalGit Bash.
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
```

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 /Users/octocat/my-site/.git/
# Creates a new folder on your computer, initialized as a Git repository

Wechsle in das Verzeichnis des Repositorys.

$ cd REPOSITORY-NAME
# Changes the working directory

Entscheide, welche Veröffentlichungsquelle du verwenden möchtest. Weitere Informationen findest du unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren. 1. 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
```
Wenn du deine Website aus der gh-pages-Verzweigung veröffentlichen möchtest, erstelle die Verzweigung und prüfe die gh-pages-Verzweigung.
```
$ 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
```

Um eine neue Jekyll-Website zu erstellen, verwendest du den jekyll new-Befehl:

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

Öffne die Gemfile, die Jekyll erstellt hat.
Füge „#“ am Anfang der Zeile hinzu, die mit gem "jekyll" beginnt, um diese Zeile auszukommentieren.
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.
Speichere und schließe das Gemfile.
Führe bundle install über die Befehlszeile aus.

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 Aufteilen eines Unterordners in ein neues Repository.

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

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

Füge deine Arbeit hinzu und übernimm sie.

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

Füge dein Repository auf deine GitHub Enterprise Server-Instanz 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
```
Ü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
```
Konfiguriere deine Veröffentlichungsquelle. Weitere Informationen finden Sie unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren. 1. Navigiere in GitHub Enterprise Server zum Repository Deiner Website. 1. Klicke unter dem Repositorynamen auf Einstellungen.
Klicke auf der Randleiste im Abschnitt „Code und Automatisierung“ auf Seiten.
Um deine veröffentlichte Website anzuzeigen, klicke unter „GitHub Pages“ auf Website besuchen.

Hinweis: Nach dem Pushen der Änderung an GitHub Enterprise Server kann es bis zu 10 Minuten dauern, bis die Änderungen an deiner Website veröffentlicht werden. Wenn deine GitHub Pages-Websiteänderungen nach einer Stunde noch immer nicht in deinem Browser angezeigt werden, lies die Informationen zu Jekyll-Buildfehlern für GitHub Pages-Websites.

Hinweis: Wenn die Veröffentlichung über einen Branch erfolgt und deine Website nicht automatisch veröffentlicht wurde, stelle sicher, dass jemand mit Administratorberechtigungen und einer verifizierten E-Mail-Adresse einen Push an die Veröffentlichungsquelle ausgeführt hat.

Nächste Schritte

Informationen zum Hinzufügen einer neuen Seite oder eines Beitrags zu deiner Website findest du unter Hinzufügen von Inhalten zu deiner GitHub Pages-Website mithilfe von Jekyll.

Du kannst zu Deiner GitHub Pages-Website ein Jekyll-Design hinzufügen, um das Erscheinungsbild Deiner Website anzupassen. Weitere Informationen findest du unter Hinzufügen eines Designs zu deiner GitHub Pages-Website mithilfe von Jekyll.