{"meta":{"title":"Синтаксис форм категорий обсуждений","intro":"Для определения полей в формах категорий обсуждений можно использовать синтаксис YAML.","product":"GitHub Discussions","breadcrumbs":[{"href":"/ru/discussions","title":"GitHub Discussions"},{"href":"/ru/discussions/managing-discussions-for-your-community","title":"Управление обсуждениями"},{"href":"/ru/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms","title":"Синтаксис форм категорий обсуждений"}],"documentType":"article"},"body":"# Синтаксис форм категорий обсуждений\n\nДля определения полей в формах категорий обсуждений можно использовать синтаксис YAML.\n\n## Сведения о синтаксисе YAML для форм категорий обсуждений\n\nВы можете создать настраиваемые формы категорий обсуждений, добавив файл определения формы YAML в папку `/.github/DISCUSSION_TEMPLATE/` в репозитории. Если вы не знакомы с YAML и хотите узнать больше, ознакомьтесь с разделом [\"Сведения о YAML\" в минутах](https://learnxinyminutes.com/docs/yaml/) Y.\n\nИмя должно соответствовать слизь для одной из категорий обсуждений. Например, шаблон категории \"Объявления\" должен быть `.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| Ключ.    | Description                                                                                   | Обязательное поле | Тип                                        |\n| :------- | :-------------------------------------------------------------------------------------------- | :---------------- | :----------------------------------------- |\n| `body`   | Определение типов входных данных в форме обсуждения.                                          | Обязательное поле | Массив                                     |\n| `labels` | Метки, которые будут автоматически добавлены в обсуждения, созданные с помощью этого шаблона. | Необязательно     | Массив или строка с разделителями-запятыми |\n| `title`  | Заголовок по умолчанию, который будет заполнен в форме отправки обсуждения.                   | Необязательно     | Строка                                     |\n\nЧтобы добавить поля в форму, добавьте массив элементов формы в `body` ключ. Список доступных элементов и их синтаксиса см. в разделе [Синтаксис схемы форм GitHub](/ru/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema)."}