{"meta":{"title":"Syntaxe des formulaires de catégorie de discussion","intro":"Vous pouvez utiliser la syntaxe YAML pour définir les champs dans vos formulaires de catégorie de discussion.","product":"GitHub Discussions","breadcrumbs":[{"href":"/fr/discussions","title":"GitHub Discussions"},{"href":"/fr/discussions/managing-discussions-for-your-community","title":"Gestion des discussions"},{"href":"/fr/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms","title":"Syntaxe des formulaires de catégorie de discussion"}],"documentType":"article"},"body":"# Syntaxe des formulaires de catégorie de discussion\n\nVous pouvez utiliser la syntaxe YAML pour définir les champs dans vos formulaires de catégorie de discussion.\n\n## À propos de la syntaxe YAML pour les formulaires de catégorie de discussion\n\nVous pouvez créer des formulaires de catégorie de discussion en ajoutant un fichier de définition de formulaire YAML au dossier `/.github/DISCUSSION_TEMPLATE/` de votre dépôt. Si vous débutez avec YAML et souhaitez en savoir plus, consultez [Découvrir YAML en Y minutes](https://learnxinyminutes.com/docs/yaml/).\n\nLe nom doit correspondre au slug de l’une de vos catégories de discussion. Par exemple, le modèle pour la catégorie « Announcements » doit être `.github/DISCUSSION_TEMPLATE/announcements.yml`.\n\nPour chaque champ, vous pouvez définir le type d’entrée, la validation et une étiquette par défaut.\n\nQuand un membre de la communauté remplit un formulaire de discussion, ses réponses pour chaque entrée sont converties en texte Markdown avant d’être ajoutées au corps d’une discussion. Les membres de la communauté peuvent modifier leurs discussions qui ont été créées à l’aide d’un formulaire de discussion et d’autres personnes peuvent interagir avec la discussion comme une discussion créée par d’autres méthodes.\n\nCet exemple de fichier de configuration YAML définit un formulaire de catégorie de discussion général.\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## Syntaxe de niveau supérieur\n\nLe fichier de configuration d’un formulaire de catégorie de discussion doit contenir une clé `body`, et `body` doit contenir au moins 1 champ non-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\nVous pouvez définir les clés principales suivantes pour chaque formulaire correspondant à une catégorie de discussion.\n\n| Clé      | Description                                                                | Obligatoire | Type                                         |\n| :------- | :------------------------------------------------------------------------- | :---------- | :------------------------------------------- |\n| `body`   | Définition des types d’entrée dans le formulaire de discussion.            | Obligatoire | Array                                        |\n| `labels` | Étiquettes ajoutées automatiquement aux discussions créées avec ce modèle. | Facultatif  | Tableau ou chaîne délimitée par des virgules |\n| `title`  | Titre par défaut prérempli dans le formulaire d’envoi de la discussion.    | Facultatif  | String                                       |\n\nPour ajouter des champs à votre formulaire, incluez un tableau d’éléments de formulaire dans la clé `body`. Pour obtenir la liste des éléments disponibles et leur syntaxe, consultez [Syntaxe du schéma de formulaire de GitHub](/fr/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema)."}