Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

À propos des listes de tâches

Vous pouvez utiliser des listes de tâches pour diviser vos problèmes en sous-tâches.

Remarque : Les listes de tâches et les champs Suivis et Suivis par pour les projets sont actuellement en version bêta privée et sont susceptibles d’être modifiés. Si vous souhaitez essayer des listes de tâches et utiliser les nouveaux champs, vous pouvez rejoindre la liste d’attente.

À propos des listes de tâches

Les listes de tâches prennent en charge les hiérarchies de problèmes sur GitHub pour vous aider à suivre vos problèmes, à les diviser en sous-tâches et à créer des relations entre eux.

Les listes de tâches s’appuient sur l’itération précédente des listes de tâches bêta et prennent toujours en charge la conversion d’éléments en problèmes, l’affichage de la progression d’une liste de tâches et la création d’une relation « suivis/suivi par » entre les problèmes.

Les problèmes que vous ajoutez à vos listes de tâches sont automatiquement renseignés avec les personnes responsables et toute étiquette appliquée.

Image montrant des listes de tâches en action

À propos de l’intégration à projects

Le panneau latéral de votre projet affiche la place d’un problème dans la hiérarchie dans un menu de navigation, ce qui vous permet de parcourir les problèmes inclus dans vos listes de tâches. Vous pouvez également ajouter les champs Suivis et Suivi par à vos vues de projet pour voir rapidement les relations entre vos problèmes. Pour plus d’informations, consultez « À propos des champs Suivis et Suivi par ».

Création de listes de tâches

Vous pouvez créer une liste d tâches dans une description de problème. Créez un bloc de code délimité et incluez [tasklist] en regard des accents graves d’ouverture. Vous pouvez ensuite préfacer chaque élément avec - [ ] et inclure des liens vers d’autres problèmes ou du texte. Vous pouvez éventuellement inclure un titre en tant qu’en-tête Markdown en haut de votre liste.

```[tasklist]
### Tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft issue title
```

Votre Markdown sera rendu par GitHub sous la forme d’une liste de tâches. Vous pouvez ensuite apporter des modifications et ajouter des problèmes et des brouillons de problèmes à l’aide de l’interface utilisateur. Si vous modifiez la description du problème, vous pouvez modifier le Markdown directement ou le copier pour dupliquer la liste de tâches dans d’autres problèmes.

Vous pouvez également cliquer sur dans la barre d’outils de mise en forme pour insérer une liste de tâches lors de la création d’un problème ou de la modification d’une description de problème.

Capture d’écran montrant le bouton « Ajouter une liste de tâches »

Ajout de problèmes à une liste de tâches

  1. En bas de votre liste de tâches, cliquez sur Ajouter un élément aux tâches.

    Capture d’écran montrant le bouton « Ajouter un élément aux tâches »

  2. Sélectionnez le problème à ajouter à votre liste de tâches.

    • Pour ajouter un problème récemment mis à jour à partir du dépôt, cliquez sur le problème dans le menu déroulant ou utilisez les touches de direction pour le sélectionner, puis appuyez sur Entrée.

      Capture d’écran montrant les problèmes récents

    • Pour rechercher un problème dans le dépôt, commencez à taper le titre d’un problème ou le numéro du problème et cliquez sur le résultat. Vous pouvez également utiliser les touches de direction pour sélectionner le problème et appuyer sur Entrée.

      Capture d’écran montrant comment rechercher un problème

    • Pour ajouter un problème directement à l’aide de son URL, collez l’URL d’un problème et appuyez sur Entrée.

      Capture d’écran montrant l’URL d’un problème collé

Créer des brouillons de problèmes dans une liste de tâches

Les brouillons de problèmes sont utiles pour capturer rapidement des idées que vous pouvez convertir par la suite en problèmes. Contrairement aux problèmes et aux demandes de tirage (pull requests) référencées à partir de vos dépôts, les brouillons de problèmes n’existent que dans votre liste de tâches.

  1. En bas de votre liste de tâches, cliquez sur Ajouter un élément aux tâches.

    Capture d’écran montrant le bouton « Ajouter un élément aux tâches »

  2. Tapez le titre de votre brouillon de problème, puis appuyez sur Entrée.

    Capture d’écran montrant le titre d’un brouillon de problème

Conversion de brouillons de problèmes en problèmes dans une liste de tâches

Vous pouvez convertir des brouillons de problèmes en problèmes. Les problèmes sont créés dans le même dépôt que le problème parent de la liste de tâches.

  1. À côté du brouillon de problème que vous souhaitez convertir, cliquez sur .

    Capture d’écran montrant l’icône du menu.

  2. Dans le menu, cliquez sur Convertir en problème.

    Capture d’écran de l’option « Convertir en problème »

Suppression d’un problème ou d’un brouillon de problème d’une liste de tâches

Vous pouvez supprimer des problèmes et des brouillons de problèmes de votre liste de tâches. Les problèmes supprimés d’une liste de tâches ne sont pas supprimés du dépôt.

  1. À côté du brouillon de problème que vous souhaitez supprimer, cliquez sur .

    Capture d’écran montrant l’icône du menu.

  2. Dans le menu, cliquez sur Supprimer.

    Capture d’écran montrant l’option « Supprimer »

Modification du titre d’une liste de tâches

Quand vous créez une liste de tâches, le titre par défaut est « Tâches ». Vous pouvez changer le titre en modifiant le Markdown du problème.

  1. En haut à droite du corps du problème, cliquez sur .

    Capture d’écran montrant l’emplacement de l’icône de menu

  2. Dans le menu, cliquez sur Modifier.

    Capture d’écran montrant l’option Modifier

  3. Remplacez l’en-tête dans le bloc de code délimité par votre nouveau titre. Par exemple, remplacez ### Tasks par ### My new title.

    Capture d’écran montrant l’option Modifier

  4. Cliquez sur Mettre à jour le commentaire.

Copie d’une liste de tâches

Quand vous copiez votre liste de tâches à l’aide de l’option « Copier le Markdown », GitHub copie le Markdown dans le Presse-papiers et inclut le nom du problème pour vous permettre de coller la liste de tâches en dehors de GitHub sans perdre le contexte.

  1. En haut à droite de votre liste de tâches, cliquez sur .

    Capture d’écran montrant l’icône du menu.

  2. Dans le menu, cliquez sur Copier le Markdown.

    Capture d’écran montrant l’option « Copier le Markdown »