Informationen zu GitHub Seiten und Jekyll

Jekyll ist ein Generator für statische Websites mit integrierter Unterstützung von GitHub Pages.

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. Siehe Pläne von GitHub.

In diesem Artikel

Hinweis

Das Gem github-pages wird zwar für einige Workflows weiterhin unterstützt, allerdings ist GitHub Actions jetzt der empfohlene Ansatz für die Bereitstellung und Automatisierung von GitHub Pages-Websites.

Informationen zu Jekyll

Jekyll ist ein Generator für statische Websites mit integrierter Unterstützung von GitHub Pages und einem vereinfachten Build-Prozess. Jekyll erstellt aus Markdown- und HTML-Dateien eine statische Website und nutzt dabei die von Dir ausgewählten Layouts. Jekyll unterstützt Markdown und Liquid, eine Vorlagensprache, die dynamische Inhalte auf deiner Website lädt. Weitere Informationen findest du unter Jekyll.

Jekyll wird für Windows nicht offiziell unterstützt. Weitere Informationen finden Sie unter Jekyll auf Windows in der Dokumentation zu Jekyll.

Wir empfehlen, Jekyll mit GitHub Pages zu verwenden. Wenn du möchtest, kannst du aber auch andere Generatoren für statische Websites verwenden oder deinen eigenen Build-Prozess lokal oder auf einem anderen Server anpassen. Weitere Informationen finden Sie unter Erstellen einer GitHub Pages-Seite.

Jekyll in der GitHub Pages-Website konfigurieren

Die meisten Jekyll-Einstellungen, z. B. das Design und die Plug-Ins Ihrer Site, können Sie durch Bearbeitung der Datei _config.yml konfigurieren. Weitere Informationen findest du in der Jekyll-Dokumentation unter Konfiguration.

Einige Konfigurationseinstellungen können für GitHub Pages-Websites nicht geändert werden.

lsi: false
safe: true
source: [your repo's top level directory]
incremental: false
highlighter: rouge
gist:
  noscript: false
kramdown:
  math_engine: mathjax
  syntax_highlighter: rouge

Standardmäßig erstellt Jekyll keine Dateien und Ordner, auf die Folgendes zutrifft:

  • Sie befinden sich in einem Ordner namens /node_modules oder /vendor.
  • Sie beginnen mit _, . oder #.
  • Am Ende mit ~.
  • Sie werden durch die Einstellung exclude in der Konfigurationsdatei ausgeschlossen.

Wenn du möchtest, dass Jekyll solche Dateien verarbeitet, kannst du dies mit der include-Einstellung in der Konfigurationsdatei festlegen.

Einleitung

Um Variablen und Metadaten wie Titel und Layout für eine Seite oder einen Beitrag auf Deiner Seite zu setzen, kannst Du YAML-Titelei zuoberst in jeder Markdown- oder HTML-Datei hinzufügen. Weitere Informationen findest du in der Jekyll-Dokumentation unter Front Matter.

Du kannst site.github einem Beitrag oder einer Seite hinzufügen, um deiner Website Metadaten für Repositoryreferenzen hinzuzufügen. Weitere Informationen finden Sie in der Jekyll-Metadaten-Dokumentation unter Verwendung von site.github.