README file from
Githubdot-kanban
A kanban board of the vault's tasks, in any note: a dot-kanban code block shows one column per checkbox status and one card per task; dragging a card rewrites the task's checkbox in its note. No database: tasks stay plain Markdown lines, in the formats of the Tasks plugin. No network access. Documentation below is in French (see « Divulgations » for vault access); the interface is in English and French.
Un tableau kanban des tâches du vault, dans n'importe quelle note : un bloc de code
```dot-kanban affiche une colonne par statut, c'est-à-dire par coche ([ ], [<], [/], [x],
[?]…), et une carte par tâche. Glisser une carte d'une colonne à l'autre réécrit la coche
de la tâche dans sa note. Il n'y a ni base de données ni fichier propre au tableau : la
tâche reste une ligne de Markdown ordinaire, lisible sans le plugin.
Aucune dépendance. Les priorités, dates et récurrences s'écrivent comme dans le module Tasks ; s'il est installé, le tableau sait aussi terminer une tâche récurrente et ouvrir sa fenêtre d'édition.
Installer
Depuis Obsidian, une fois le plugin au catalogue : Paramètres → Modules complémentaires → Parcourir, chercher dot-kanban. Anciennement Tasks in Kanban : voir la migration.
Ou depuis les releases, Obsidian fermé :
VAULT=~/Documents/MonVault
mkdir -p "$VAULT/.obsidian/plugins"
unzip -o dot-kanban-*.zip -d "$VAULT/.obsidian/plugins"
Puis activer dot-kanban dans les modules complémentaires. Le détail, avec
vérification des sommes, est dans installer ; depuis les sources, npm ci && npm run build.
Divulgations
Ce que le plugin fait du coffre, comme le demandent les règles du catalogue :
- Liste des notes : pour rassembler les tâches du coffre, le plugin parcourt la liste de ses notes Markdown. Il interroge d'abord le cache d'Obsidian et ne lit le contenu que des notes qui contiennent des tâches. Le filtre
path includesd'un tableau restreint ce qui est affiché, pas ce qui est parcouru. - Écriture : seulement quand vous déplacez, cochez ou modifiez une carte, et seulement la ligne de cette tâche, si elle est retrouvée intacte ; sinon rien n'est écrit. Sur un tableau de notes (
cards notes), déplacer une carte écrit la propriété de la colonne ou du groupe dans les propriétés de cette note, et rien d'autre. - Ni réseau, ni compte, ni télémétrie, ni publicité. Aucun fichier hors du coffre. Code source ouvert, licence MIT ; les releases GitHub portent une attestation de provenance.
Utiliser
Dans une note, en lecture ou en aperçu en direct (la commande Insérer un tableau dot-kanban colle un bloc commenté) :
```dot-kanban
column [ ] À faire
column [<] Planifié
column [/] En cours
column [x] Fait | sort by done reverse | limit 20
path includes Projets/
```
Chaque tâche - [ ] des notes retenues devient une carte. Une carte se glisse vers une
autre colonne (souris, tactile ou clavier) ; sa coche la termine ; clic droit règle
priorité et échéance et Ouvrir la note, à côté ou dans un onglet. Chaque
écriture se défait par Annuler dans la notification ou Ctrl+Z.
Une colonne se teinte (column [/] En cours | color blue), les cartes changent de taille
(size small, size large avec les sous-tâches), et cards notes fait une carte par note,
rangée selon une propriété (columns by statut) que le glisser réécrit.
[owner:: Alice] (ou [o:: Alice]) assigne une tâche ; owner: Alice dans les propriétés
d'une note assigne toutes ses tâches. group by owner range les cartes par personne ; d'un
groupe à l'autre, une carte se glisse aussi. L'ordre des rangées s'impose
(group by owner | order reverse, | order Bob, Alice).
Ajouter crée une tâche, dans la fenêtre de Tasks s'il est installé, et l'écrit à la fin
de la note que le bloc nomme (add to Projets/Inbox.md) : chaque tableau a la sienne.
Tout tient en une page dans le guide ; le premier tableau déroule ces étapes ; la syntaxe du bloc et le format des tâches décrivent le reste.
Ce qu'il garantit, et ce qu'il ne fait pas
- Une action ne modifie que la ligne de la tâche, et seulement si elle la retrouve : si la
tâche a changé entre-temps, rien n'est écrit et une notification le dit. Sur un tableau
de notes, elle ne modifie qu'une propriété de la note. Ajouter n'écrit qu'une ligne,
à la fin de la note nommée par
add to. - Rien n'est caché sans le dire : les tâches lues mais non affichées sont comptées dans le résumé, avec leur raison ; une ligne du bloc non comprise est signalée avec son numéro.
- Le HTML d'une tâche est affiché comme du texte, jamais interprété.
- Pas d'ordre manuel dans une colonne : l'ordre est calculé (
sort by). Une tâche ajoutée va dans une seule note, pas dans la colonne ni la note de son choix. Linux validé dans de vraies fenêtres Obsidian ; macOS, Windows et mobile pas encore, voir compatibilité.
Documentation
Index · Dépanner · Architecture · Tester · Publier une release · Spécification · Changelog.