Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。

ディスカッション カテゴリ フォームの作成

コミュニティのメンバーがリポジトリで新しいディスカッションを開くときに使えるテンプレートをカスタマイズできます。

注: ディスカッション カテゴリ フォームは現在、限定パブリック ベータ版であり、変更される可能性があります。

ディスカッション カテゴリ フォームについて

リポジトリ内でディスカッション フォームを使って、コミュニティ メンバーがディスカッションに特定の構造化された情報を含めるよう促すことができます。 ディスカッション カテゴリ フォームを使うと、カスタマイズできる Web フォーム フィールドがあるディスカッション テンプレートを作成できます。 ディスカッション フォームは、GitHub フォーム スキーマを使って YAML で記述します。 詳細については、「GitHub のフォーム スキーマの構文」を参照してください。

YAML を初めて使用する場合は、「Learn YAML in Y minutes」 (YAML を Y 分で学習する) を参照してください。

リポジトリでディスカッション カテゴリ フォームを使うには、新しいファイルを作成して、それをお使いのリポジトリの /.github/DISCUSSION_TEMPLATE/ フォルダーに追加する必要があります。

Organization 用にディスカッション カテゴリ フォームを作成することもできます。 詳細については、「既定のコミュニティ正常性ファイルの作成」を参照してください。

ディスカッション カテゴリ フォームは、投票ではサポートされていません。 投票について詳しくは、「投票について」をご覧ください。

Issueフォームのレンダリングバージョンは次のとおりです。

レンダリングされたディスカッション カテゴリ フォームのスクリーンショット

ディスカッション カテゴリ フォームの作成

ディスカッション カテゴリ フォームは、リポジトリへの書き込みアクセス権を持つユーザーが作成できます。

  1. ディスカッション カテゴリ フォームを作成するリポジトリに移動します。
  2. リポジトリで、FORM-NAME をディスカッション カテゴリ フォーム フォームの名前に置き換えて、/.github/DISCUSSION_TEMPLATE/FORM-NAME.yml という名前のファイルを作成します。 名前は、いずれかのディスカッション カテゴリのスラッグに対応している必要があります。 たとえば、"Announcements" カテゴリのテンプレートは、.github/DISCUSSION_TEMPLATE/announcements.yml にする必要があります。 GitHub で新しいファイルを作成する方法について詳しくは、「新しいファイルの作成」をご覧ください。
  3. 新しいファイルの本文に、ディスカッション カテゴリ フォームの内容を入力します。 詳しくは、ディスカッション カテゴリ フォームの構文に関する説明をご覧ください。
  4. ファイルをリポジトリのデフォルトブランチにコミットします。 詳細については、「新しいファイルの作成」を参照してください。