{"meta":{"title":"ディスカッション カテゴリ フォームの構文","intro":"YAML 構文を使用すると、ディスカッション カテゴリ フォームのフィールドを定義できます。","product":"GitHub Discussions","breadcrumbs":[{"href":"/ja/discussions","title":"GitHub Discussions"},{"href":"/ja/discussions/managing-discussions-for-your-community","title":"ディスカッションを管理する"},{"href":"/ja/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms","title":"ディスカッション カテゴリ フォームの構文"}],"documentType":"article"},"body":"# ディスカッション カテゴリ フォームの構文\n\nYAML 構文を使用すると、ディスカッション カテゴリ フォームのフィールドを定義できます。\n\n## ディスカッション カテゴリ フォームの YAML 構文について\n\nYAML フォーム定義ファイルをリポジトリの `/.github/DISCUSSION_TEMPLATE/` フォルダーに追加することで、カスタム ディスカッション カテゴリ フォームを作成できます。 YAML の初心者で詳しく学びたい場合は、「[Learn YAML in Y minutes](https://learnxinyminutes.com/docs/yaml/)」(YAML を Y 分で学ぶ) を参照してください。\n\n名前は、いずれかのディスカッション カテゴリのスラッグに対応している必要があります。 たとえば、\"Announcements\" カテゴリのテンプレートは、`.github/DISCUSSION_TEMPLATE/announcements.yml` にする必要があります。\n\nフィールドごとに、入力の種類、検証、および既定のラベルを定義できます。\n\nコミュニティ メンバーがディスカッション フォームに入力すると、それぞれの入力に対する回答が Markdown に変換され、ディスカッションの本文に追加されます。 コミュニティ メンバーは、ディスカッション フォームで作成されたディスカッションを編集でき、他のユーザーは、他の方法で作成されたディスカッションのようにディスカッションとやり取りできます。\n\nこの YAML 構成ファイルの例では、一般的なディスカッション カテゴリ フォームを定義します。\n\n```yaml copy\ntitle: \"[General] \"\nlabels: [\"General Introduction\"]\nbody:\n  - type: markdown\n    attributes:\n      value: |\n        This is text that will show up in the template!\n  - type: textarea\n    id: improvements\n    attributes:\n      label: Top 3 improvements\n      description: \"What are the top 3 improvements we could make to this project?\"\n      value: |\n        1.\n        2.\n        3.\n        ...\n      render: bash\n    validations:\n      required: true\n  - type: markdown\n    attributes:\n      value: |\n        ## Markdown header\n        And some more markdown\n  - type: input\n    id: has-id\n    attributes:\n      label: Suggestions\n      description: A description about suggestions to help you\n    validations:\n      required: true\n  - type: dropdown\n    id: download\n    attributes:\n      label: Which area of this project could be most improved?\n      options:\n        - Documentation\n        - Pull request review time\n        - Bug fix time\n        - Release cadence\n    validations:\n      required: true\n  - type: checkboxes\n    attributes:\n      label: Check that box!\n      options:\n        - label: This one!\n          required: true\n        - label: I won't stop you if you check this one, too\n  - type: markdown\n    attributes:\n      value: |\n        ### The thrilling conclusion\n        _to our template_\n```\n\n## 最上位の構文\n\nディスカッション カテゴリ フォームの構成ファイルには `body` キーが含まれている必要があり、`body` には少なくとも 1 つの Markdown 以外のフィールドが含まれている必要があります。\n\n```yaml copy\nbody:\n- type: input\n  id: suggestion\n  attributes:\n    label: Suggestion\n    description: \"How might we make this project better?\"\n    placeholder: \"Adding a CODE_OF_CONDUCT.md file would be a great idea.\"\n  validations:\n    required: true\n```\n\n各ディスカッション カテゴリ フォームに次の最上位のキーを設定できます。\n\n| キー       | 説明                                   | 必須    | タイプ             |\n| :------- | :----------------------------------- | :---- | :-------------- |\n| `body`   | ディスカッション フォームでの入力の種類の定義。             | 必須    | Array           |\n| `labels` | このテンプレートで作成されたディスカッションに自動的に追加されるラベル。 | オプション | 配列またはコンマ区切りの文字列 |\n| `title`  | ディスカッション送信フォームに事前に設定される既定のタイトル。      | オプション | String          |\n\nフォームにフィールドを追加するには、フォーム要素の配列を `body` キーに含めます。 使用できる要素とその構文の一覧については、「[GitHubのフォーム スキーマの構文](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema)」を参照してください。"}