====== 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 ====
<code dokuwiki>
  * <todo>Rédiger la documentation technique</todo>
</code>

==== Assigner un responsable (@) ====
Ajoutez `@` suivi du login DokuWiki de l'utilisateur :
<code dokuwiki>
  * <todo @alex>Corriger le bug d'affichage sur le formulaire</todo>
</code>

==== Ajouter une date d'échéance (#) ====
Ajoutez `#` suivi de la date au format ISO (`AAAA-MM-JJ`) :
<code dokuwiki>
  * <todo #2026-08-15>Envoyer le rapport financier</todo>
  * <todo @sophie #2026-08-20>Valider les maquettes avec le client</todo>
</code>

==== Sous-tâches et hiérarchie ====
Indentez avec **4 espaces** avant l'astérisque pour créer un sous-niveau :
<code dokuwiki>
  * <todo @thomas>Projet de refonte</todo>
    * <todo @alex>Design de la page d'accueil</todo>
    * <todo @marie>Intégration CSS</todo>
</code>

---

===== 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 ====
<code dokuwiki>
{{todo>}}
</code>

==== Récapitulatif par espace de nom (Namespace) ====
<code dokuwiki>
{{todo>projets:client_a}}
</code>

==== Filtrer par utilisateur ====
<code dokuwiki>
{{todo>@alex}}
</code>

---

===== 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 :

<code dokuwiki>
====== 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}}
</code>

---

===== 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.
  *