{"meta":{"title":"토론 범주 양식의 구문","intro":"YAML 구문을 사용하여 토론 범주 양식의 필드를 정의할 수 있습니다.","product":"GitHub Discussions","breadcrumbs":[{"href":"/ko/discussions","title":"GitHub Discussions"},{"href":"/ko/discussions/managing-discussions-for-your-community","title":"토론 관리"},{"href":"/ko/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을 처음 사용하며 자세히 알아보려는 경우 [Y분 안에 YAML 알아보기](https://learnxinyminutes.com/docs/yaml/)를 참조하세요.\n\n이름은 토론 범주 중 하나의 슬러그와 일치해야 합니다. 예를 들어 \"공지\" 범주에 대한 템플릿은 `.github/DISCUSSION_TEMPLATE/announcements.yml`이어야 합니다.\n\nYAML을 처음 사용하며 자세히 알아보려는 경우 [Y분 안에 YAML 알아보기](https://learnxinyminutes.com/docs/yaml/)를 참조하세요.\n\n이름은 토론 범주 중 하나의 슬러그와 일치해야 합니다. 예를 들어 \"공지\" 범주에 대한 템플릿은 `.github/DISCUSSION_TEMPLATE/announcements.yml`이어야 합니다.\n각 필드에 대해 입력 형식, 유효성 검사 및 기본 레이블을 정의할 수 있습니다.\n\n커뮤니티 구성원이 토론 양식을 작성하면 각 입력에 대한 응답이 마크다운으로 변환되어 토론 본문에 추가됩니다.\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이 예제 YAML 구성 파일은 일반 토론 범주 양식을 정의합니다.\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```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| 최상위 구문 | 토론 범주 양식의 구성 파일에는 `body`키가 포함되어야 하며, `body`에는 Markdown이 아닌 필드가 1개 이상 포함되어야 합니다. | 각 토론 카테고리 양식에 대해 다음과 같은 최상위 키를 설정할 수 있습니다. | 키 |\n| :-- | :-- | :-- | :-- |\n| `body` | 설명 | 필수 | 유형 |\n| `labels` | 토론 양식의 입력 형식에 대한 정의입니다. | 필수 | 배열 |\n| `title` | 이 템플릿을 사용하여 만든 토론에 자동으로 추가될 레이블입니다. | 선택 사항 | 배열 또는 쉼표로 구분된 문자열 |\n\n토론 제출 양식에 미리 채워지는 기본 제목입니다. 선택 사항"}