Hinzufügen von Inhalten zu Ihrer GitHub Seitenwebsite mithilfe von Jekyll

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 finden Sie unter AUTOTITLE.

Die hauptsächlichen Arten von Inhalten für Jekyll-Websites sind Seiten und Beiträge. Eine Seite ist für eigenständige Inhalte gedacht, die nicht mit einem bestimmten Datum verknüpft sind, z. B. eine "Über uns"-Seite. Die Jekyll-Standardwebsite enthält eine Datei mit dem Namen , die als Seite auf deiner Website unter gerendert 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 in der Jekyll-Dokumentation unter „Seiten“.

Bei einem Beitrag handelt es sich um einen Blog-Beitrag. Die Jekyll-Standardwebsite enthält ein Verzeichnis namens , das eine Datei mit einem Standardposting enthält. Du kannst den Inhalt dieses Beitrags bearbeiten und den Standardbeitrag als Vorlage für neue Beiträge verwenden. Weitere Informationen findest du in der Jekyll-Dokumentation unter „Posts“.

Dein Design umfasst Standardlayouts und -stylesheets, die automatisch auf neue Seiten und Beiträge auf deiner Website angewendet werden. Du kannst diese Standardwerte jedoch überschreiben. Weitere Informationen finden Sie unter AUTOTITLE.

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.

Bei einer Veröffentlichung über einen Branch, werden Änderungen an deiner Website automatisch veröffentlicht, wenn die Änderungen in der Veröffentlichungsquelle der Website zusammengeführt werden. Falls die Veröffentlichung über einen benutzerdefinierten GitHub Actions-Workflow erfolgt, werden Änderungen bei jeder Auslösung des Workflows veröffentlicht (in der Regel durch einen Push an den Standardbranch). Wenn du zuerst eine Vorschau deiner Änderungen sehen möchtest, kannst du die Änderungen lokal vornehmen anstatt auf GitHub. Dann teste deine Website lokal. Weitere Informationen finden Sie unter Lokales Testen Ihrer GitHub-Seite mit Jekyll.

Eine neue Seite zu deiner Website hinzufügen

1. Navigiere auf GitHub zum Repository deiner Website.

2. Navigiere zur Veröffentlichungsquelle für deine Website. Weitere Informationen finden Sie unter Konfigurieren einer Quelle zur Veröffentlichung für Ihre GitHub Pages-Seite.

3. Erstelle im Stammverzeichnis deiner Veröffentlichungsquelle eine neue Datei mit dem Namen PAGE-NAME für deine Seite und ersetze „PAGE-NAME“ durch einen aussagekräftigen Dateinamen für die Seite.

4. Füge am Anfang der Datei den folgenden YAML-Frontmatter ein, 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 <BASE_URL> und dein URL-PATH <URL_PATH> lautet, befindet sich deine Seite unter <PAGE_URL>.

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

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

6. Klicke auf Änderungen committen.

7. Gib im Feld „Commitnachricht“ eine kurze, aussagekräftige Commitnachricht ein, die die Änderung beschreibt, die Du an der Datei vorgenommen hast. Du kannst den Commit in der Commit-Mitteilung mehr als einem Autor zuordnen. Weitere Informationen finden Sie unter Einen Commit mit mehreren Autoren erstellen.

8. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Dein Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. Wenn dein aktueller Branch als Standardbranch festgelegt ist, solltest du einen neuen Branch für deinen Commit und dann einen Pull Request erstellen. Weitere Informationen finden Sie unter Erstellen eines Pull Requests.

   

9. Klicke auf Änderungen committen oder Änderungen vorschlagen.

10. Erstelle einen Pull Request für deine vorgeschlagenen Änderungen.

11. Klicke in der Liste „Pull Requests“ auf den Pull Request, den du mergen möchtest.

12. Klicke auf Pull Request mergen. Weitere Informationen finden Sie unter Einen Pull Request zusammenführen.

13. Wenn Du dazu aufgefordert wirst, gib eine Commit-Mitteilung ein oder akzeptiere die Standardmitteilung.

14. Klicke auf Merge bestätigen.

15. Lösche optional den Branch. Weitere Informationen finden Sie unter Erstellen und Löschen von Branches in deinem Repository.

Einen neuen Beitrag zu deiner Website hinzufügen

1. Navigiere auf GitHub zum Repository deiner Website.

2. Navigiere zur Veröffentlichungsquelle für deine Website. Weitere Informationen finden Sie unter Konfigurieren einer Quelle zur Veröffentlichung für Ihre GitHub Pages-Seite.

3. Navigiere zum Verzeichnis .

4. Erstelle eine neue Datei mit dem Namen , und ersetze dabei „YYYY-MM-DD“ durch das Datum deines Beitrags und „NAME-OF-POST“ durch den Namen deines Beitrags.

5. Füge am Anfang der Datei den folgenden YAML-Frontmatter hinzu: Schreibe den Titel des Beitrags in Anführungszeichen, gib das Datum und die Uhrzeit des Beitrags im Format „JJJJ-MM-TT hh:mm:ss -0000“ an, und füge beliebig viele Kategorien für deinen Beitrag hinzu.

   layout: post
   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. Klicke auf Änderungen committen.

8. Gib im Feld „Commitnachricht“ eine kurze, aussagekräftige Commitnachricht ein, die die Änderung beschreibt, die Du an der Datei vorgenommen hast. Du kannst den Commit in der Commit-Mitteilung mehr als einem Autor zuordnen. Weitere Informationen finden Sie unter Einen Commit mit mehreren Autoren erstellen.

9. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Dein Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. Wenn dein aktueller Branch als Standardbranch festgelegt ist, solltest du einen neuen Branch für deinen Commit und dann einen Pull Request erstellen. Weitere Informationen finden Sie unter Erstellen eines Pull Requests.

   

10. Klicke auf Änderungen committen oder Änderungen vorschlagen.

11. Erstelle einen Pull Request für deine vorgeschlagenen Änderungen.

12. Klicke in der Liste „Pull Requests“ auf den Pull Request, den du mergen möchtest.

13. Klicke auf Pull Request mergen. Weitere Informationen finden Sie unter Einen Pull Request zusammenführen.

14. Wenn Du dazu aufgefordert wirst, gib eine Commit-Mitteilung ein oder akzeptiere die Standardmitteilung.

15. Klicke auf Merge bestätigen.

16. Lösche optional den Branch. Weitere Informationen finden Sie unter Erstellen und Löschen von Branches in deinem Repository.

Der Beitrag sollte jetzt auf deiner Website angezeigt werden! Wenn die Basis-URL deiner Website lautet, dann befindet sich dein neuer Beitrag unter .

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