Artikelversion: Enterprise Server 2.17
Eine einzelne Issue-Vorlage für Dein Repository manuell erstellen
Wenn Du eine manuell erstellte Issuevorlage zu Deinem Repository hinzufügst, sehen Projektmitarbeiter automatisch den Inhalt der Vorlage im Text des Issues.
Dies ist der Legacy-Workflow zum Erstellen einer Issue-Vorlage. Wir empfehlen den Einsatz des aktualisierten Mehrfachissue-Vorlagengenerators um Mehrfachissue-Vorlagen zu erstellen. Weitere Informationen findest Du unter „Informationen zu Vorlagen für Issues und Pull-Requests.“
Du kannst in einem der unterstützten Ordner ein Unterverzeichnis ISSUE_TEMPLATE erstellen, um mehrere Issuevorlagen zu speichern. Mit dem Abfrageparameter template
kannst Du die Vorlage festlegen, mit der der Issue-Text ausgefüllt werden soll. Weitere Informationen findest Du unter „Informationen zur Automatisierung für Issues und Pull Requests mit Abfrageparametern.“
Du kannst YAML-Titelei zu jeder Issuevorlage hinzufügen, um den Issuetitel vorab auszufüllen, automatisch Kennzeichnungen und Bearbeiter hinzuzufügen und der Vorlage einen Namen und eine Beschreibung zu geben, die in der Vorlagenauswahl angezeigt wird, die Personen bei Erstellen von neuen Issues in Deinem Repository sehen.
Hier ist ein Beispiel für eine YAML-Titelei.
---
name: Issue verfolgen
about: Benutzer diese Vorlage zum verfolgen neuer Funktionen.
title: "[DATE]: [FEATURE NAME]"
labels: Issue verfolgen, benötigt Bewertung
assignees: octocat
---
Hinweis: Du musst reserviert YAML-Zeichen wie beispielsweise :
in Anführungszeichen setzen. Beispiel: ":bug: Bug"
.
Du kannst Standard-Issue-Vorlagen für Deine Organisation erstellen. Weitere Informationen findest Du unter „Erstellen einer Standard-Community-Unterstützungsdatei."
Eine Issuevorlage hinzufügen
- Navigiere in GitHub Enterprise zur Hauptseite des Repository.
- Klicke oberhalb der Dateiliste auf Create new file (neue Datei erstellen).
- Gib Folgendes im Feld für den Dateinamen ein:
- Wenn die Issuevorlage im Stammverzeichnis des Repositorys sichtbar sein soll, gib den Namen Deiner issue_template ein. Beispiel:
issue_template.md
. - Wenn die Issuevorlage im
docs
-Verzeichnis des Repositorys sichtbar sein soll, gib docs/ ein, gefolgt vom Namen der issue_template. Beispiel:docs/issue_template.md
, - Um Deine Datei in einem ausgeblendeten Verzeichnis zu speichern, gib .github ein, gefolgt vom Namen der issue_template. Beispiel:
.github/issue_template.md
. - Um mehrere Issuevorlagen zu erstellen und mithilfe des Abfrageparameters
template
eine Vorlage zum Ausfüllen des Issue-Texts festzulegen, gib .github/ISSUE_TEMPLATE/ ein, gefolgt vom Namen der Issuevorlage. Beispiel:.github/ISSUE_TEMPLATE/issue_template.md
. Du kannst auch mehrere Issuevorlagen in einem UnterverzeichnisISSUE_TEMPLATE
innerhalb des Stammverzeichnisses oder indocs/
-Verzeichnissen speichern. Weitere Informationen findest Du unter „Informationen zur Automatisierung für Issues und Pull Requests mit Abfrageparametern.“
- Wenn die Issuevorlage im Stammverzeichnis des Repositorys sichtbar sein soll, gib den Namen Deiner issue_template ein. Beispiel:
- Füge im Text der neuen Datei Deine Issuevorlage hinzu. Sie könnte beispielsweise Folgendes enthalten:
- YAML-Titelei
- Erwartetes und tatsächliches Verhalten
- Schritte zum Reproduzieren des Problems
- Spezifikationen wie die Version des Projektes, das Betriebssystem oder die Hardware
- 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"
- 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."Vorlagen sind für Mitarbeiter verfügbar, wenn sie in den Standardbranch des Repositorys gemergt wurden. - Klicke auf Propose new file (Neue Datei vorschlagen)