Inhalte zur GitHub Pages-Website mit Jekyll hinzufügen

Personen mit Schreibberechtigungen für ein Repository können mit Jekyll Inhalte zu einer GitHub Pages-Website hinzufügen.

Informationen zu Inhalten von Jekyll-Websites

Bevor Du Inhalte zu einer Jekyll-Website auf GitHub Pages hinzufügen kannst, musst Du eine Jekyll-Website erstellen. Weitere Informationen findest Du unter „Eine GitHub Pages-Website mit Jekyll erstellen.“

Die hauptsächlichen Arten von Inhalten für Jekyll-Websites sind Seiten und Beiträge. Eine Seite wird für eigenständige Inhalte genutzt, die nicht mit einem bestimmten Datum verknüpft sind, z. B. eine Seite mit Informationen zu Deiner Person oder Organisation. Die standardmäßige Jekyll-Website enthält eine Datei mit dem Namen about.md, die als Seite Deiner Website unter YOUR-SITE-URL/about angezeigt wird. Du kannst den Inhalt dieser Datei bearbeiten, um Deine Informationsseite zu personalisieren. Die Informationsseite kannst Du außerdem als Vorlage für neue Seiten verwenden. Weitere Informationen findest Du unter „Pages“ (Seiten) in der Jekyll-Dokumentation.

Bei einem Beitrag handelt es sich um einen Blog-Beitrag. Die standardmäßige Jekyll-Website enthält ein Verzeichnis mit dem Namen _posts, das eine Standardbeitrags-Datei enthält. Du kannst den Inhalt dieses Beitrags bearbeiten und den Standardbeitrag als Vorlage für neue Beiträge verwenden. Weitere Informationen findest Du unter „Posts“ (Beiträge) in der Jekyll-Dokumentation.

Dein Design umfasst standardmäßige Layouts, Includes und Stylesheets, die automatisch auf neue Seiten und Beiträge auf Deiner Website angewendet werden. Du kannst diese Standardeinstellungen aber überschreiben. Weitere Informationen findest Du unter „Informationen zu GitHub Pages und Jekyll.“

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 unter „Titelei" in der Jekyll Dokumentation.

Änderungen an Deiner Website werden automatisch veröffentlicht, wenn die Änderungen in der Veröffentlichungsquelle Deiner Website zusammengeführt werden. Wenn Du zuerst eine Vorschau Ihrer Änderungen sehen möchtest, kannst Du die Änderungen lokal vornehmen statt auf GitHub Enterprise. Dann teste Deine Website lokal. Weitere Informationen findest Du unter „GitHub Pages-Website lokal mit Jekyll testen“.

Eine neue Seite zu Deiner Website hinzufügen

1. Navigiere in GitHub Enterprise zum Repository Deiner Website.

2. Navigiere zur Veröffentlichungsquelle für Deine Website. Weitere Informationen zu Veröffentlichungsquellen findest Du unter „Informationen zu GitHub Pages“.

3. Erstelle im Root-Verzeichnis Deiner Veröffentlichungsquelle eine neue Datei für Deine Seite mit dem Namen PAGE-NAME.md, und ersetze dabei PAGE-NAME durch einen aussagekräftigen Dateinamen für die Seite.

4. Füge den folgenden YAML-Frontmatter oben in der Datei hinzu, und ersetze dabei PAGE TITLE durch den Titel der Seite und URL-PATH durch den gewünschten Pfad für die URL der Seite. Wenn beispielsweise die Basis-URL Deiner Website https://octocat.github.io lautet und der URL-Pfad (URL-PATH) /about/contact/ ist, findet sich Deine Seite unter https://octocat.github.io/about/contact.

   layout: page
   title: "PAGE TITLE"
   permalink: /URL-PATH/

5. Füge unterhalb des Frontmatter den Inhalt für Deine Seite hinzu.

6. Am Ende der Seite schreibe eine kurze, aussagekräftige Commit-Mitteilung, welche die Änderung beschreibt, welche Du an der Datei vornimmst. Du kannst den Commit in der Commit-Mitteilung mehr als einem Autor zuordnen. Weitere Informationen findest Du unter "Erstellen eines Commit mit mehreren Co-Autoren"

   

7. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Dein Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. Weitere Informationen findest Du unter „Erstellen eines neuen Pull Requests."

   

8. Klicke auf Propose file change (Dateiänderung vorschlagen).

   

Einen neuen Beitrag zu Deiner Website hinzufügen

1. Navigiere in GitHub Enterprise zum Repository Deiner Website.

2. Navigiere zur Veröffentlichungsquelle für Deine Website. Weitere Informationen zu Veröffentlichungsquellen findest Du unter „Informationen zu GitHub Pages“.

3. Navigiere zum Verzeichnis _posts.

4. Erstelle eine neue Datei mit dem Namen YYYY-MM-DD-NAME-OF-POST.md, wobei Du YYYY-MM-DD durch das Datum des Beitrags und NAME-OF-POST durch den Namen des Beitrags ersetzt.

5. Füge den folgenden YAML-Frontmatter oben in der Datei hinzu, und ersetze dabei POST TITLE durch den Titel des Beitrags, YYYY-MM-DD hh:mm:ss -0000 durch das Datum und die Uhrzeit für den Beitrag und CATEGORY-1 und CATEGORY-2 durch so viele Kategorien, wie Dein Beitrag aufweisen soll.

   layout: page
   title: "POST TITLE"
   date: YYYY-MM-DD hh:mm:ss -0000
   categories: CATEGORY-1 CATEGORY-2

6. Füge unterhalb des Frontmatters den Inhalt für Deinen Beitrag hinzu.

7. Am Ende der Seite schreibe eine kurze, aussagekräftige Commit-Mitteilung, welche die Änderung beschreibt, welche Du an der Datei vornimmst. Du kannst den Commit in der Commit-Mitteilung mehr als einem Autor zuordnen. Weitere Informationen findest Du unter "Erstellen eines Commit mit mehreren Co-Autoren"

   

8. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Dein Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. Weitere Informationen findest Du unter „Erstellen eines neuen Pull Requests."

   

9. Klicke auf Propose file change (Dateiänderung vorschlagen).

   

Nächste Schritte:

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 zu Deiner GitHub Pages-Website mit Jekyll hinzufügen.“