Eine einzelne Issue-Vorlage für Ihr Repository manuell erstellen
Wenn Sie eine manuell erstellte Issue-Vorlage zu Ihrem Repository hinzufügen, sehen Projektmitarbeiter automatisch den Inhalt der Vorlage im Text des Issues.
Inhalt dieses Artikels
This is the legacy workflow to create an issue template. We recommend using the upgraded multiple issue template builder to create multiple issue templates. Weitere Informationen finden Sie unter „Informationen zu Vorlagen für Issues und Pull Requests“.
Sie können in einem der unterstützten Ordner ein Unterverzeichnis ISSUE_TEMPLATE erstellen, um mehrere Issue-Vorlagen zu speichern. Mit dem Abfrageparameter template
können Sie die Vorlage festlegen, mit der der Issue-Text ausgefüllt werden soll. Weitere Informationen finden Sie unter „Informationen zur Automatisierung für Issues und Pull Requests mit Abfrageparametern“.
You can add YAML frontmatter to each issue template to pre-fill the issue title, automatically add labels and assignees, and give the template a name and description that will be shown in the template chooser that people see when creating a new issue in your repository.
Here is example YAML front matter.
---
name: Tracking issue
about: Use this template for tracking new features.
title: "[DATE]: [FEATURE NAME]"
labels: tracking issue, needs triage
assignees: octocat, octo-org/octo-team
---
Note: You must put YAML-reserved characters such as :
in quotes. For example, ":bug: Bug"
.
Eine Issue-Vorlage hinzufügen
-
Navigieren Sie in GitHub Enterprise zur Repository-Hauptseite.
-
Above the file list, click Create new file.
-
Geben Sie Folgendes im Feld für den Dateinamen ein:
- Wenn die Issue-Vorlage im Root-Verzeichnis des Repositorys sichtbar sein soll, geben Sie den Namen der issue_template ein, z. B.
issue_template.md
. - Wenn die Issue-Vorlage im
docs
-Verzeichnis des Repositorys sichtbar sein soll, geben Sie docs/ ein, gefolgt vom Namen der <0>issue_template</0>, z. B.docs/issue_template.md
. - Um Ihre Datei in einem ausgeblendeten Verzeichnis zu speichern, geben Sie .github ein, gefolgt vom Namen der <0>issue_template</0>, z. B.
.github/issue_template.md
. - Um mehrere Issue-Vorlagen zu erstellen und mithilfe des Abfrageparameters
template
eine Vorlage zum Ausfüllen des Issue-Textes festzulegen, geben Sie .github/ISSUE_TEMPLATE/ ein, gefolgt vom Namen der Issue-Vorlage. Beispiel:.github/ISSUE_TEMPLATE/issue_template.md
. Sie können auch mehrere Issue-Vorlagen in einem UnterverzeichnisISSUE_TEMPLATE
innerhalb des Root-Verzeichnisses oder indocs/
-Verzeichnissen speichern. Weitere Informationen finden Sie unter „Informationen zur Automatisierung für Issues und Pull Requests mit Abfrageparametern“.
- Wenn die Issue-Vorlage im Root-Verzeichnis des Repositorys sichtbar sein soll, geben Sie den Namen der issue_template ein, z. B.
-
Fügen Sie im Text der neuen Datei Ihre Issue-Vorlage hinzu. Sie könnte beispielsweise Folgendes enthalten:
- YAML frontmatter
- Expected behavior and actual behavior
- Steps to reproduce the problem
- Specifications like the version of the project, operating system, or hardware
-
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."
-
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."Vorlagen sind für Mitarbeiter verfügbar, wenn sie in den Standardbranch des Repositorys gemergt wurden. -
Click Propose new file.