Plugin Todo : Guide et Bonnes Pratiques
Le plugin Todo permet de créer, d'assigner et de suivre des tâches sous forme de listes interactives directement dans vos pages DokuWiki.
1. Syntaxe de base en liste
Pour un rendu propre et aéré, insérez toujours vos balises `< todo >` dans des listes à puces DokuWiki (avec 2 espaces avant l'astérisque ` * `).
Tâche simple
* <todo>Rédiger la documentation technique</todo>
Assigner un responsable (@)
Ajoutez `@` suivi du login DokuWiki de l'utilisateur :
* <todo @alex>Corriger le bug d'affichage sur le formulaire</todo>
Ajouter une date d'échéance (#)
Ajoutez `#` suivi de la date au format ISO (`AAAA-MM-JJ`) :
* <todo #2026-08-15>Envoyer le rapport financier</todo> * <todo @sophie #2026-08-20>Valider les maquettes avec le client</todo>
Sous-tâches et hiérarchie
Indentez avec 4 espaces avant l'astérisque pour créer un sous-niveau :
* <todo @thomas>Projet de refonte</todo>
* <todo @alex>Design de la page d'accueil</todo>
* <todo @marie>Intégration CSS</todo>
—
2. Afficher la liste récapitulative (Agrégation)
Vous pouvez regrouper automatiquement toutes vos tâches sur une page centrale de tableau de bord.
Récapitulatif global
{{todo>}}
Récapitulatif par espace de nom (Namespace)
{{todo>projets:client_a}}
Filtrer par utilisateur
{{todo>@alex}}
—
3. Modèle de page complet (Prêt à l'emploi)
Voici une structure de page de projet tirant pleinement parti de la mise en page en listes imbriquées :
====== Suivi de Projet : Refonte du Site ======
===== 📌 Phase 1 : Infrastructure & Backend =====
* <todo @thomas #2026-08-10>Mise en place de l'environnement</todo>
* <todo @thomas>Mettre à jour le serveur de staging</todo>
* <todo @alex>Optimiser la base de données</todo>
* <todo @marie #2026-08-12>Spécifications fonctionnelles</todo>
* <todo @marie>Rédiger les cas d'utilisation</todo>
===== 🎨 Phase 2 : Design & Contenu =====
* <todo @sophie #2026-08-18>Maquettes graphiques</todo>
* <todo @sophie>Valider la charte auprès du client</todo>
* <todo @alex>Décliner les bannières mobiles</todo>
* <todo>Préparer les textes de présentation</todo>
* Remarque : Attendre la validation du service juridique.
===== 📊 Tableau de bord centralisé =====
{{todo>projets:refonte}}
—
4. Astuces & Bonnes Pratiques
- La règle des espaces : Respectez scrupuleusement le formatage DokuWiki pour les listes :
- ` * ` (2 espaces, astérisque, 1 espace) pour le niveau principal.
- ` * ` (4 espaces, astérisque, 1 espace) pour une sous-tâche.
- Format de date ISO : Utilisez toujours `#AAAA-MM-JJ` (ex: `#2026-08-15`) pour que le plugin ordonne chronologiquement les échéances dans le tableau de bord.
- Correspondance des pseudos : Le nom précédé de `@` doit correspondre au login DokuWiki exact de l'utilisateur.
- Nettoyage périodique : Cocher une tâche enregistre l'état directement dans le code source de la page. Supprimez périodiquement les anciennes tâches validées pour préserver la clarté de la page.
- 💳 Faire un don maintenant (lien à venir)
- 📧 Pour toute question ou suggestion, contactez-moi.
Merci pour votre soutien ! 🌸