Inhalte zur GitHub Pages-Website mit Jekyll hinzufügen

Sie können zu Ihrer Jekyll-Website auf GitHub Pages eine neue Seite oder einen neuen Beitrag hinzufügen.

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub's products."

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 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 Standard-Beitragsdatei 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. Dann teste Deine Website lokal. Weitere Informationen findest Du unter „Deine GitHub Pages-Website lokal mit Jekyll testen.“

Eine neue Seite zu Deiner Website hinzufügen

  1. Navigiere in GitHub 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" Commit-Mitteilung für Deine Änderung

  7. If you have more than one email address associated with your GitHub account, click the email address drop-down menu and select the email address to use as the Git author email address. Nur verifizierte E-Mail-Adressen werden in diesem Dropdownmenü angezeigt. Wenn Sie den Datenschutz für E-Mail-Adressen aktiviert haben, dann ist <username>@users.noreply.github.com die standardmäßige Commit-Autor-E-Mail-Adresse. Weitere Informationen findest Du unter „Deine Commit-E-Mail-Adresse festlegen.“ Wähle Commit E-Mail-Adressen

  8. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Deinen Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchtest. 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." Branch-Optionen für Commit

  9. Klicke auf Propose file change (Dateiänderung vorschlagen). Schaltfläche „Propose file change" (Dateiänderung vorschlagen)

  10. Create a pull request for your proposed changes.

  11. In the "Pull Requests" list, click the pull request you would like to merge.

  12. Click Merge pull request. Weitere Informationen findest Du unter „Einen Pull Request zusammenführen.“

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

  14. Click Confirm merge.

  15. Optionally, delete the branch. Weitere Informationen findest Du unter „Branches in Deinem Repository erstellen und löschen.“

Einen neuen Beitrag zu Deiner Website hinzufügen

  1. Navigiere in GitHub 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: 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. 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" Commit-Mitteilung für Deine Änderung

  8. If you have more than one email address associated with your GitHub account, click the email address drop-down menu and select the email address to use as the Git author email address. Nur verifizierte E-Mail-Adressen werden in diesem Dropdownmenü angezeigt. Wenn Sie den Datenschutz für E-Mail-Adressen aktiviert haben, dann ist <username>@users.noreply.github.com die standardmäßige Commit-Autor-E-Mail-Adresse. Weitere Informationen findest Du unter „Deine Commit-E-Mail-Adresse festlegen.“ Wähle Commit E-Mail-Adressen

  9. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Deinen Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchtest. 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." Branch-Optionen für Commit

  10. Klicke auf Propose file change (Dateiänderung vorschlagen). Schaltfläche „Propose file change" (Dateiänderung vorschlagen)

  11. Create a pull request for your proposed changes.

  12. In the "Pull Requests" list, click the pull request you would like to merge.

  13. Click Merge pull request. Weitere Informationen findest Du unter „Einen Pull Request zusammenführen.“

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

  15. Click Confirm merge.

  16. Optionally, delete the branch. Weitere Informationen findest Du unter „Branches in Deinem Repository erstellen und löschen.“

Your post should now be up on your site! If the base URL of your site is https://octocat.github.io, then your new post will be located at https://octocat.github.io/YYYY/MM/DD/TITLE.html.

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

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Oder, learn how to contribute.