Inhalte zur GitHub Pages-Website mit Jekyll hinzufügen

Inhalt dieses Artikels

• Informationen zu Inhalten von Jekyll-Websites
• Eine neue Seite zu Ihrer Website hinzufügen
• Einen neuen Beitrag zu Ihrer Website hinzufügen
• Nächste Schritte:

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

To set variables and metadata, such as a title and layout, for a page or post on your site, you can add YAML front matter to the top of any Markdown or HTML file. For more information, see "Front Matter" in the Jekyll documentation.

Changes to your site are published automatically when the changes are merged into your site's publishing source. If you want to preview your changes first, you can make the changes locally instead of on GitHub Enterprise. Then, test your site locally. Weitere Informationen finden Sie unter „GitHub Pages-Website lokal mit Jekyll testen“.

Eine neue Seite zu Ihrer Website hinzufügen

1. On GitHub Enterprise, navigate to your site's repository.

2. Navigate to the publishing source for your site. Weitere Informationen zu Veröffentlichungsquellen finden Sie 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. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

   

1. Legen Sie unter den Commit-Mitteilungsfeldern fest, ob Sie Ihr Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

   

2. Klicken Sie auf Propose file change (Dateiänderung vorschlagen).

   

Einen neuen Beitrag zu Ihrer Website hinzufügen

1. On GitHub Enterprise, navigate to your site's repository.

2. Navigate to the publishing source for your site. Weitere Informationen zu Veröffentlichungsquellen finden Sie 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. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

   

1. Legen Sie unter den Commit-Mitteilungsfeldern fest, ob Sie Ihr Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

   

2. Klicken Sie auf Propose file change (Dateiänderung vorschlagen).

   

Nächste Schritte:

You can add a Jekyll theme to your GitHub Pages site to customize the look and feel of your site. Weitere Informationen finden Sie unter „Ein Design zu Ihrer GitHub Pages-Website mit Jekyll hinzufügen“.