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 Sie Inhalte zu einer Jekyll-Website auf GitHub Pages hinzufügen können, müssen Sie eine Jekyll-Website erstellen. Weitere Informationen finden Sie 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 Ihrer Person oder Organisation. Die standardmäßige Jekyll-Website enthält eine Datei mit dem Namen about.md, die als Seite Ihrer Website unter YOUR-SITE-URL/about angezeigt wird. Sie können den Inhalt dieser Datei bearbeiten, um Ihre Informationsseite zu personalisieren. Die Informationsseite können Sie außerdem als Vorlage für neue Seiten verwenden. Weitere Informationen finden Sie 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. Sie können den Inhalt dieses Beitrags bearbeiten und den Standardbeitrag als Vorlage für neue Beiträge verwenden. Weitere Informationen finden Sie unter „Posts“ (Beiträge) in der Jekyll-Dokumentation.

Ihr Design umfasst standardmäßige Layouts, Includes und Stylesheets, die automatisch auf neue Seiten und Beiträge auf Ihrer Website angewendet werden. Sie können diese Standardeinstellungen aber überschreiben. Weitere Informationen finden Sie 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 Ihrer 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. Erstellen Sie im Root-Verzeichnis Ihrer Veröffentlichungsquelle eine neue Datei für Ihre Seite mit dem Namen PAGE-NAME.md, und ersetzen Sie dabei PAGE-NAME durch einen aussagekräftigen Dateinamen für die Seite.

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

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

5. Fügen Sie unterhalb des Frontmatters den Inhalt für Ihre 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. Wenn Dein aktueller Branch Master ist, solltest Du einen neuen Branch für Deinen Commit erstellen und dann einen Pull-Request erstellen. Weitere Informationen findest Du unter „Erstellen eines neuen Pull-Requests."

   

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

   

Einen neuen Beitrag zu Ihrer 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. Navigieren Sie zum Verzeichnis _posts.

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

5. Fügen Sie den folgenden YAML-Frontmatter oben in der Datei hinzu, und ersetzen Sie 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 Ihr Beitrag aufweisen soll.

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

6. Fügen Sie unterhalb des Frontmatters den Inhalt für Ihren 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. Wenn Dein aktueller Branch Master ist, solltest Du einen neuen Branch für Deinen Commit erstellen und dann einen Pull-Request erstellen. 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 finden Sie unter „Ein Design zu Ihrer GitHub Pages-Website mit Jekyll hinzufügen“.