--- tags: - note - pkm - atomique type: "note" univers: PERSO projects: - "[[02_DOMAINES/PERSO-PKM]]" date: "2026-08-02" priority: 10 --- # Notion de note atomique dans un PKM C'est une excellente question, et c'est justement le nœud du problème dans tout PKM basé sur des notes atomiques (SilverBullet, Obsidian, Logseq...). Il y a un principe général qui répond aux deux exemples, puis des nuances propres à chaque cas. ## Le principe général : notes atomiques + notes "hub" La règle de base : **une note = une idée qui a du sens seule et qui pourrait être liée depuis plusieurs endroits différents.** Si un contenu ne remplit pas cette condition (il n'a de sens que dans un contexte précis, ou personne ne le lierait depuis ailleurs), il n'a pas besoin d'être une note séparée — un simple lien ou une section suffit. À côté de ça, il y a un deuxième type de note, complémentaire : la **note "hub" (ou MOC — "Map of Content")**, qui ne contient pas de connaissance en soi, mais organise et met en relation plusieurs notes atomiques autour d'un thème ou d'un contexte. Ces deux notions résolvent votre problème de "contexte différent pour une même notion". ## Exemple 1 — Les valeurs dans les arts martiaux Ne créez pas une note "Courage" et une autre "Courage dans les arts martiaux" avec du contenu qui se recoupe. Structurez plutôt ainsi : * **Notes atomiques par valeur** : `Courage`, `Équilibre`, `Honnêteté`, `Justice` — chacune traite la notion de façon générale/universelle (définition, réflexions personnelles, citations, liens vers d'autres notions proches). * **Une note hub** : `Valeurs dans les arts martiaux` — celle-ci ne redéfinit pas le courage ou la justice, elle explique **comment ces valeurs s'incarnent spécifiquement dans ce contexte** (rituels du dojo, code du bushido, anecdotes d'entraînement...), et fait un lien `[[Courage]]`, `[[Justice]]`, etc. vers chaque note atomique concernée. Concrètement dans la note hub : ``` # Valeurs dans les arts martiaux Les arts martiaux traditionnels s'appuient sur un socle de valeurs codifiées, souvent héritées du bushido japonais. ## [[Courage]] Dans le contexte martial, le courage se manifeste moins dans l'affrontement que dans la capacité à rester calme face à la peur... ## [[Justice]] ... ``` L'avantage : si un jour vous étudiez le courage dans un autre contexte (le stoïcisme, le monde professionnel...), vous créez une autre note hub (`Courage en contexte professionnel`) sans jamais dupliquer la définition de base. La note `Courage` s'enrichit avec le temps de tous ces liens entrants (visibles via les **backlinks** de SilverBullet), ce qui devient un bel indicateur de la richesse du concept. **Règle de décision simple** : si le contenu spécifique à un contexte fait plus de quelques lignes et pourrait lui-même être découpé ou enrichi indépendamment → note séparée liée. Si c'est juste une remarque ponctuelle → un paragraphe avec un lien suffit. ## Exemple 2 — Redimensionnement d'image / ImageMagick Même logique, mais avec un angle légèrement différent : ici on distingue **note-tâche** (orientée "comment faire") et **note-outil** (orientée référence sur un logiciel). * **Note-outil `ImageMagick`** : présente l'outil dans son ensemble — installation, syntaxe générale, ses grandes capacités (resize, conversion de format, colorisation, watermark...) — sans entrer dans le détail de chaque usage. * **Notes-tâche par cas d'usage** : `Redimensionner une image`, `Coloriser une image`, `Convertir un format d'image`... Chacune explique la tâche en général, puis présente les différentes méthodes possibles en liant vers les outils concernés : `[[ImageMagick]]`, `[[Caesium]]`, `[[GIMP]]`. Concrètement : ``` # Redimensionner une image ## Avec [[ImageMagick]] mogrify -resize 1600x1600> -quality 80 *.jpg ## Avec [[Caesium]] caesiumclt -q 80 --max-width 1600 -o ./output/ *.jpg ``` Et la note `ImageMagick` référence en retour, via ses backlinks automatiques, toutes les tâches où elle est utilisée (resize, mais aussi colorisation si vous la traitez un jour) — vous voyez alors d'un coup d'œil tout ce que fait cet outil dans votre pratique, sans avoir eu à le lister manuellement. **Pourquoi ce découpage plutôt qu'une seule note "ImageMagick" avec tout dedans ?** Parce que dans 6 mois, si vous cherchez "comment redimensionner une image", vous ne voulez pas devoir vous souvenir que c'est rangé sous "ImageMagick" — la vraie question que vous vous posez porte sur la tâche, pas sur l'outil. Le découpage par tâche colle à la façon dont vous allez chercher l'information plus tard. ## Astuce SilverBullet pour automatiser tout ça Vous pouvez utiliser des **tags** en front matter (`tags: [valeur]`, `tags: [outil, image]`) puis une petite requête Lua/Query sur votre note hub ou une page d'index pour lister automatiquement toutes les notes correspondantes, sans maintenir les liens à la main : ``` ${query[[from index.tag "outil" where tags.includes "image"]]} ``` Ça vous évite d'oublier de lier une nouvelle note-outil à son index. ## Récapitulatif de la règle de décision | Situation | Choix | | --- | --- | | Le concept a un sens indépendant du contexte | Note atomique séparée | | Le contenu ne fait sens que dans un contexte précis, court | Section + lien, pas de note séparée | | Plusieurs contextes traitent le même concept différemment | Notes hub par contexte, qui lient vers la note atomique | | Un outil sert à plusieurs tâches différentes | Note-outil (référence) + notes-tâche séparées qui la lient | Cette logique vous évitera la duplication tout en gardant une recherche intuitive, quel que soit l'angle par lequel vous repensez à une notion plus tard. --- Exemple Voici un exemple complet et concret, avec le contenu réel des notes (pas juste la structure), pour que vous voyiez bien comment les deux types de notes s'articulent et se répondent. --- ## Note atomique : `Courage` ```markdown --- tags: [valeur, notion] --- # Courage Le courage est la capacité à agir malgré la peur, le risque ou l'incertitude, en vue d'un objectif jugé important ou juste. ## Distinctions - **Courage physique** : affronter un danger corporel (douleur, blessure, mort). - **Courage moral** : assumer une position, dire une vérité inconfortable, résister à la pression sociale. - Le courage n'est pas l'absence de peur, mais la décision d'agir malgré elle — sans cette peur, on parlerait plutôt d'inconscience ou de témérité. ## Notions liées - [[Peur]] - [[Témérité]] (l'excès du courage) - [[Lâcheté]] (le défaut du courage) - Aristote situe le courage comme un juste milieu — voir [[Éthique de la mesure]] ## Contextes où cette notion est mobilisée - [[Valeurs dans les arts martiaux]] - [[Courage en contexte professionnel]] ``` Remarquez : cette note ne parle **jamais** de dojo, de kata ou de bushido. Elle reste valable pour n'importe quel contexte d'étude. --- ## Note atomique : `Justice` ```markdown --- tags: [valeur, notion] --- # Justice La justice consiste à donner à chacun ce qui lui est dû, selon un principe d'équité ou de règle établie. ## Distinctions - **Justice distributive** : répartition équitable des ressources, reconnaissance, sanctions. - **Justice commutative** : équité dans les échanges directs entre individus. ## Notions liées - [[Équité]] - [[Honnêteté]] - [[Loi]] vs [[Morale]] ## Contextes où cette notion est mobilisée - [[Valeurs dans les arts martiaux]] ``` --- ## Note hub : `Valeurs dans les arts martiaux` ```markdown --- tags: [hub, arts-martiaux] --- # Valeurs dans les arts martiaux Les arts martiaux traditionnels (japonais notamment) s'appuient sur un socle de valeurs codifiées, souvent héritées du **bushido**, le code d'honneur des samouraïs. Cette note explore comment ces valeurs s'incarnent concrètement dans la pratique martiale. ## [[Courage]] (勇気 - yūki) Dans le dojo, le courage se manifeste moins dans l'affrontement physique que dans la capacité à se présenter face à un adversaire plus expérimenté, à encaisser l'échec public devant le groupe, ou à continuer un combat malgré la fatigue. C'est un courage "d'usure" plus qu'un courage "d'instant". > Anecdote personnelle : lors de mon premier combat en compétition, > j'ai compris que le courage n'était pas l'absence de tremblement, > mais la décision d'avancer quand même. ## [[Justice]] (義 - gi) La justice martiale se traduit par le refus d'exploiter un avantage déloyal (frapper un adversaire à terre, profiter d'une blessure) et par le respect strict des règles de l'école, même sans arbitre pour les faire respecter. ## [[Honnêteté]] (誠 - makoto) Elle s'exprime dans la reconnaissance publique de ses erreurs techniques devant le sensei, plutôt que dans la dissimulation d'un manque de maîtrise. ## Synthèse Ce qui distingue l'éthique martiale d'une éthique "de salon", c'est que ces valeurs sont testées en conditions de stress physique réel — le corps sous tension révèle le caractère plus sûrement que le discours. ## Voir aussi - [[Bushido]] - [[Stoïcisme]] (parallèles intéressants avec le courage stoïcien) ``` --- ## Ce que ça vous donne concrètement 1. **Aucune duplication** : la définition générale du courage n'existe qu'à un seul endroit (`Courage`). Si vous l'affinez un jour, tout le reste en profite sans rien retoucher ailleurs. 2. **Les backlinks travaillent pour vous** : en ouvrant la note `Courage` dans SilverBullet, son panneau de liens entrants affichera automatiquement `Valeurs dans les arts martiaux` (et plus tard `Courage en contexte professionnel` si vous la créez). Vous voyez alors, sans rien maintenir à la main, **tous les contextes** où vous avez réfléchi au courage. 3. **La note hub reste courte et lisible** : elle ne contient que ce qui est *spécifique* aux arts martiaux, pas de rappel de définition générale — ce qui évite qu'elle devienne un fourre-tout de 3000 mots. 4. **Ça scale bien** : si demain vous étudiez les valeurs dans un autre contexte (le scoutisme, une entreprise, la philosophie stoïcienne...), vous créez une nouvelle note hub sur ce modèle, sans jamais retoucher aux notes atomiques `Courage` ou `Justice`. Une astuce en bonus : dans SilverBullet, vous pouvez inverser la vue avec une requête sur la note `Courage` elle-même, pour lister automatiquement tous les hubs qui la citent : ``` ${query[[from index.link "Courage"]]} ``` Ça vous évite même de maintenir à la main la section "Contextes où cette notion est mobilisée" que j'ai mise dans l'exemple — SilverBullet peut la générer dynamiquement. --- ==Ne pas dupliquer le terme courage ou justice comme mot-clé== Non, ce n'est généralement pas nécessaire, et je déconseillerais même de le faire systématiquement. Voici pourquoi. **Le lien `[[Courage]]` fait déjà tout le travail qu'un tag ferait** Un tag `courage` sur une note servirait à répondre à la question "quelles notes parlent de courage ?". Mais c'est exactement ce que fait déjà le wikilink `[[Courage]]` combiné aux backlinks automatiques de SilverBullet. Si vous ajoutez le tag `courage` en plus du lien `[[Courage]]`, vous avez deux mécanismes qui encodent la même information — et c'est une source classique de désynchronisation dans les PKM : vous éditez la note, oubliez de mettre à jour le tag, et six mois plus tard votre tag et vos liens racontent deux histoires différentes. **Principe général à retenir** : une information ne devrait avoir qu'une seule source de vérité dans votre PKM. Si un lien existe déjà et qu'une requête (`index.link`) peut retrouver l'information, un tag redondant n'apporte rien — il ajoute seulement de la maintenance. **À quoi servent alors les tags, dans ce cas précis ?** Réservez les tags à des dimensions qui **ne sont pas déjà capturées par un lien ou par le titre de la note** : * Le **type/rôle de la note** dans votre système : `valeur`, `notion`, `hub`, `outil`, `tâche` — c'est une métadonnée sur la note elle-même, pas sur son contenu. * Un **axe transversal qui n'a pas sa propre note** : par exemple `tags: [valeur, notion, philosophie-antique]` si vous voulez pouvoir retrouver toutes les notions traitées sous un angle philosophique particulier, sans pour autant vouloir créer une note atomique "Philosophie antique". * Un **statut de traitement** : `a-developper`, `brouillon`, `mature` — utile pour piloter votre PKM, pas pour indexer du contenu. Dans vos deux notes, `[valeur, notion]` sur `Courage`/`Justice` et `[hub, arts-martiaux]` sur la note hub sont donc bien calibrés : ils décrivent le *rôle* de chaque note, pendant que les liens `[[Courage]]`, `[[Justice]]` décrivent les *relations de contenu* entre elles — pas besoin de faire porter aux tags une responsabilité qu'ils remplissent déjà. **Cas où j'ajouterais quand même un tag "courage"** Si un jour vous écrivez une note qui *mentionne* le courage en passant, sans vouloir créer un vrai lien structurant (par exemple une note de lecture sur un livre qui l'évoque brièvement parmi dix autres thèmes), un tag léger peut avoir du sens comme signal faible — mais c'est l'exception, pas la règle, et ça ne concerne pas vos notes atomiques/hub qui, elles, ont déjà la relation explicitée par le lien.