{"meta":{"title":"Sintaxis de los formularios de categoría de discusión","intro":"Puedes usar la sintaxis de YAML para definir los campos de tus formularios de categoría de discusión.","product":"GitHub Discussions","breadcrumbs":[{"href":"/es/discussions","title":"GitHub Discussions"},{"href":"/es/discussions/managing-discussions-for-your-community","title":"Administrar los debates"},{"href":"/es/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms","title":"Sintaxis de los formularios de categoría de discusión"}],"documentType":"article"},"body":"# Sintaxis de los formularios de categoría de discusión\n\nPuedes usar la sintaxis de YAML para definir los campos de tus formularios de categoría de discusión.\n\n## Acerca de la sintaxis de YAML para los formularios de categoría de discusión\n\nPara crear formularios de categoría de discusión personalizados, puedes agregar un archivo de definición de formulario de YAML a la carpeta `/.github/DISCUSSION_TEMPLATE/` del repositorio. Si no tienes experiencia con YAML y quieres obtener más información, consulta [Aprende YAML en Y minutos](https://learnxinyminutes.com/docs/yaml/).\n\nEl nombre debe coincidir con el slug de una de las categorías de discusión. Por ejemplo, la plantilla de una categoría llamada \"Announcements\" debe ser `.github/DISCUSSION_TEMPLATE/announcements.yml`.\n\nEn cada campo, puedes definir el tipo de entrada, la validación y una etiqueta predeterminada.\n\nCuando un miembro de la comunidad rellena un formulario de discusión, sus respuestas en cada entrada se convierten en lenguaje de marcado y se agregan al cuerpo de una discusión. Los miembros de la comunidad pueden editar las discusiones que se han creado con un formulario de discusión, y otras personas pueden interactuar con la discusión como si fuera una discusión creada a través de otros métodos.\n\nEn este archivo de configuración YAML de ejemplo se define un formulario de categoría de discusión general.\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## Sintaxis de nivel superior\n\nEl archivo de configuración de un formulario de categoría de discusión debe contener una clave `body` y `body` debe contener al menos un campo que no sea de marcado.\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\nPuede configurar las siguientes claves de nivel superior para cada formato de categoría de discusión.\n\n| Clave    | Descripción                                                                                      | Obligatorio | Tipo                                     |\n| :------- | :----------------------------------------------------------------------------------------------- | :---------- | :--------------------------------------- |\n| `body`   | Definición de los tipos de entrada del formulario de discusión                                   | Obligatorio | Array                                    |\n| `labels` | Etiquetas que se agregarán automáticamente a las discusiones creadas con esta plantilla          | Opcionales  | Arreglo o secuencia delimitada por comas |\n| `title`  | Título predeterminado que aparecerá rellenado previamente en el formulario de envío de discusión | Opcionales  | Cadena                                   |\n\nPara agregar campos al formulario, incluye una matriz de elementos de formulario en la clave `body`. Para una lista de los elementos disponibles y sus sintaxis, consulta [Sintaxis para el esquema de formulario de GitHub](/es/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema)."}