Remarque : Les listes de tâches sont en version bêta privée et sont susceptibles d’être modifiées. Nous avons actuellement interrompu le processus d'acueil dans la version bêta.
Création de listes de tâches dans l’interface utilisateur
Vous pouvez utiliser le bouton Ajouter une liste de tâches pour ajouter rapidement une liste de tâches à votre problème. Le bouton Ajouter une liste de tâches est disponible lorsque vous affichez ou modifiez un problème.
-
Accédez au problème dans lequel vous souhaitez contenir votre nouvelle liste de tâches. Vous pouvez également créer un nouveau problème.
-
En bas de la description du problème, cliquez sur Ajouter une liste de tâches.
-
Vous pouvez ensuite ajouter des problèmes, des demandes de tirage et des brouillons de tâches à votre nouvelle liste de tâches. Pour plus d’informations, consultez « Gestion des tâches dans une liste de tâches ».
Création de listes de tâches avec Markdown
Vous pouvez créer des listes de tâches en utilisant Markdown dans la description du problème (commentaire d’ouverture d’un problème). Vous pouvez ajouter des liens vers des problèmes et des demandes de tirage, ou créer des brouillons de problème.
Vous pouvez ajouter une liste de tâches en copiant le code Markdown ci-dessous dans la description de votre problème :
```[tasklist] ### My tasks - [ ] https://github.com/octo-org/octo-repo/issues/45 - [ ] Draft task ```
```[tasklist]
### My tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft task
```
Vous pouvez également utiliser le bouton Ajouter une liste de tâches lors de la modification de votre problème pour insérer le code Markdown d’une liste de tâches :
Une fois que vous avez commencé à modifier le code Markdown de votre liste de tâches, vous pouvez ajouter de nouvelles tâches en faisant précéder chaque nouvelle tâche de - [ ]
, puis en ajoutant :
- Le brouillon d’une tâche. Les brouillons de tâches sont du texte qui peut être converti ultérieurement en problèmes.
- Lien complet vers un problème ou une demande de tirage (pull request). Par exemple :
https://github.com/octo-org/octo-repo/issues/45
. Si un problème ou une demande de tirage (pull request) se trouve dans le même référentiel que votre liste de tâches, vous pouvez utiliser la syntaxe abrégée #ISSUE-NUMBER. Par exemple :#45
.
Si vous ajoutez un brouillon de tâche, celui-ci doit répondre aux critères suivants :
- Les brouillons de tâche peuvent être mis en forme à l’aide de Markdown.
- Les brouillons de tâche ne doivent pas dépasser 512 caractères.
Votre liste de tâches est affichée par GitHub quand vous prévisualisez vos modifications et quand vous enregistrez le problème. Vous pouvez ensuite faire des changements, et ajouter des problèmes et des brouillons de tâche en utilisant l’interface utilisateur de GitHub. 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.
Changement 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 modifier le titre en cliquant sur Renommer dans le menu contextuel de la liste de tâches ou en modifiant le code Markdown du problème.
-
En haut à droit du corps du problème, sélectionnez et cliquez sur Modifier.
-
Dans le bloc de code délimité qui commence par
```[tasklist]
, ajoutez un en-tête avec votre nouveau titre, par exemple### My new title
. -
Cliquez sur Mettre à jour le commentaire.
Copie d’une liste de tâches
Quand vous copiez votre liste de tâches en utilisant l’option « Copier le Markdown », GitHub copie le Markdown dans le Presse-papiers et ajoute le titre du problème pour vous permettre de coller la liste de tâches en dehors de GitHub sans perdre le contexte. Voici ci-dessous un exemple de liste de tâches Markdown copiée :
- [x] [Design new landing page](https://github.com/octocat/octoproject/issues/4)
- [ ] [Translate content into supported languages](https://github.com/octocat/octoproject/issues/11)
-
En haut à droite de votre liste de tâches, cliquez sur .
-
Dans le menu, cliquez sur Copier le Markdown.