{"meta":{"title":"Sintaxe para formulários de categoria de discussão","intro":"Você pode usar a sintaxe YAML para definir os campos em seus formulários de categoria de discussão.","product":"GitHub Discussions","breadcrumbs":[{"href":"/pt/discussions","title":"GitHub Discussions"},{"href":"/pt/discussions/managing-discussions-for-your-community","title":"Gerenciando discussões"},{"href":"/pt/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms","title":"Sintaxe para formulários de categoria de discussão"}],"documentType":"article"},"body":"# Sintaxe para formulários de categoria de discussão\n\nVocê pode usar a sintaxe YAML para definir os campos em seus formulários de categoria de discussão.\n\n## Sobre a sintaxe YAML para formulários de categoria de discussão\n\nVocê pode criar formulários de categoria de discussão personalizados adicionando um arquivo de definição de formulário YAML à pasta `/.github/DISCUSSION_TEMPLATE/` no repositório. Se você não estiver familiarizado com o YAML e quiser saber mais, confira [Aprenda a usar o YAML em Y minutos](https://learnxinyminutes.com/docs/yaml/).\n\nO nome deve corresponder ao slug de uma de suas categorias de discussão. Por exemplo, o modelo para a categoria \"Comunicados\" deve ser `.github/DISCUSSION_TEMPLATE/announcements.yml`.\n\nPara cada campo, você pode definir o tipo de entrada, a validação e um rótulo padrão.\n\nQuando um membro da comunidade preenche um formulário de discussão, suas respostas para cada entrada são convertidas em Markdown e adicionadas ao corpo de uma discussão. Os membros da comunidade podem editar suas discussões que foram criadas com um formulário de discussão e outras pessoas podem interagir com a discussão, como uma discussão criada por meio de outros métodos.\n\nEste arquivo de configuração YAML de exemplo define um formulário de categoria de discussão geral.\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## Sintaxe de nível superior\n\nO arquivo de configuração para um formulário de categoria de discussão deve conter uma chave `body` e o `body` deve conter pelo menos 1 campo não 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\nVocê pode definir as seguintes chaves de nível superior para cada formulário de categoria de discussão.\n\n| Chave    | Descrição                                                                             | Obrigatório | Tipo                                      |\n| :------- | :------------------------------------------------------------------------------------ | :---------- | :---------------------------------------- |\n| `body`   | Definição dos tipos de entrada no formulário de discussão.                            | Obrigatório | Array                                     |\n| `labels` | Etiquetas que serão adicionadas automaticamente a discussões criadas com este modelo. | Opcional    | Matriz ou strings delimitadas por vírgula |\n| `title`  | Um título padrão que será preenchido previamente no formulário de envio de discussão. | Opcional    | String                                    |\n\nPara adicionar campos ao formulário, inclua uma matriz de elementos de formulário na chave `body`. Para obter uma lista de elementos disponíveis e suas sintaxes, confira [Sintaxe para o esquema de formulário do GitHub](/pt/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema)."}