これはIssueテンプレートを作成するためのレガシーのワークフローです。 Issueテンプレートの作成には、アップグレードされた複数IssueテンプレートビルダーあるいはIssue formsを使用することをおすすめします。 詳しい情� �についてはIssue およびPull Requestのテンプレートについてを参照してく� さい。
サポートしているどのフォルダーにでも ISSUE_TEMPLATE/ サブディレクトリを作成し、Issue テンプレートを複数含めることができます。また、template
クエリパラメータで Issue の本文に使用するテンプレートを指定できます。 詳細は「クエリパラメータによる Issue およびプルリクエストの自動化について」を参照してく� さい。
YAML frontmatter を各 Issue テンプレートに追� して、Issue のタイトルを事前に入力したり、ラベルおよびアサインされた人を自動追� したり、リポジトリに新しい Issue を作成するときに表示されるテンプレート選択画面に表示されるテンプレートの名前と説明を指定したりすることができます。
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
---
注釈: フロントマター値に :
などの YAML特殊文字が含まれている� �合は、値全体を引用符で囲む必要があります。 たとえば、":bug: Bug"
または ":new: triage needed, :bug: bug"
などです。
デフォルトのIssueテンプレートとIssueテンプレートのためのデフォルトの設定ファイルを、Organizationもしくはユーザアカウント用に作成できます。 詳しい情� �については「デフォルトのコミュニティ健全性ファイルを作成する」を参照してく� さい。
Issue テンプレートを追� する
- your GitHub Enterprise Server instanceで、リポジトリのメインページにアクセスしてく� さい。
- ファイルのリストの上で、Add file(ファイルの追� )ドロップダウンを使い、Create new file(新規ファイルの作成をクリックしてく� さい。
- ファイル名フィールドで:
- Issue テンプレートをリポジトリのルートディレクトリで表示するには、issue_template の名前を入力します。 たとえば、
issue_template.md
です。 - リポジトリの
docs
ディレクトリに Issue テンプレートを表示するには、docs/ に続けて issue_template の名前を入力します。 たとえば、docs/issue_template.md
です。 - ファイルを� しディレクトリに� �納するには、.github/ と入力し、続いて issue_template という名前を入力します。 たとえば、
.github/issue_template.md
です。 - 複数 Issue テンプレートを作成し、
template
クエリパラメータを使用して Issue の本文に使用するテンプレートを指定するには、.github/ISSUE_TEMPLATE/ と入力し、続けて Issue テンプレートの名前を入力します。 たとえば、.github/ISSUE_TEMPLATE/issue_template.md
です。 複数 Issue テンプレートをルートディレクトリやdocs/
ディレクトリにあるISSUE_TEMPLATE
サブディレクトリに� �納することもできます。 詳細は「クエリパラメータによる Issue およびプルリクエストの自動化について」を参照してく� さい。
- Issue テンプレートをリポジトリのルートディレクトリで表示するには、issue_template の名前を入力します。 たとえば、
- 新しいファイルの本文に Issue テンプレートを追� します。 そこに盛り込むべき� �目として、以下のようなものがあります:
- YAML frontmatter
- 予測される動作と実際の動作
- 問題の再現手� �
- プロジェクトのベンダー、オペレーティング システ� 、ハードウェアなどの仕様
- ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してく� さい。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しい情� �については「複数の共作者を持つコミットの作成」を参照してく� さい。
- コミットメッセージフィールドの下で、コミットを追� を現在のブランチか新しいブランチから選択してく� さい。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しい情� �については「新しいプルリクエストの作成」を参照してく� さい。 テンプレートがリポジトリのデフォルトブランチにマージされると、コラボレーターがテンプレートを使用できるようになります。
- Propose new file(新規ファイルの提案)をクリックしてく� さい。