properties (metadata) - Légèrement sérieux, sérieusement léger

# Propriétés (“Properties”) des fiches ⭢ [dans l’aide en ligne](https://publish.obsidian.md/help/Advanced+topics/YAML+front+matter) ⭢ [[Dataview|pour découvrir comment ces métadonnées peuvent être exploitées par le plugin “Dataview”]] Tout en haut de chaque fiche, on *peut* écrire des métadonnées qui concernent la fiche en question. C’est absolument facultatif, mais ça peut être très utile, en particulier lorsque le nombre de fiches d’un coffre dépasse la centaine et qu’il commence à y avoir des fiches de différentes natures. À un certain moment, ça devient indispensable quand on veut avoir, par exemple : * la liste de toutes les fiches “MOC” ou tous les index du coffre * la liste des fiches récemment écrites * la liste des fiches pas encore publiées — dans un jardin numérique * la liste des fiches avec des actions à faire — dans une gestion de projet * la liste des fiches concernant le collègue Toto * la liste des fiches avec des résumés de film * la liste des fiches avec des notes prises sur un certain sujet. Je recommande vivement de connaître et d’employer cette possibilité d’écrire des métadonnées en haut de ses fiches. En guise d’exemple, voici à quoi ressemble le bloc de métadonnées de la présente fiche : ![[Properties example.png]] Cette vue dans un panneau, que l’on obtient par la commande “Show file properties” <kbd>⇧</kbd> <kbd>⌘</kbd> <kbd>P</kbd> , est beaucoup plus pratique : ![[Properties pane sample.png]] Les informations stockées dans ces métadonnées sont, dans l’ordre : * `up` : la fiche “au-dessus” dans l’arborescence virtuelle que j’établis entre mes fiches. Je peux naviguer vers cette fiche *parent* avec le raccourci <kbd>⌥</kbd> <kbd>⌘</kbd> <kbd>↑</kbd>. * des `aliases` du nom de la fiche, afin de la trouver plus facilement et afin de faire fonctionner correctement les “Unlinked mentions”, comme expliqué ⭢ [[fiches pointant vers la fiche courante#Liens potentiels|ici]] * la date et l’heure de création de la fiche — cette donnée est entrée automatiquement par le template que j’utilise à la création d’une fiche * la date de modification de la fiche ; c’est le plugin [Front Matter Timestamps](https://obsidian.md/plugins?id=front-matter-timestamps) qui la tient à jour * `publish` : “true” indique que la fiche est publiée en ligne. Si on omet le champ `publish` ou si on lui donne la valeur “false”, la fiche n’est pas publiée (c’est-à-dire qu’elle ne risque pas d’être “uploadée” sur le site). * `obsidianUIMode:` est une métadonnée pour le plugin *[[force note view mode]]* — je vous laisse découvrir là-bas les détails * la `nature` de la fiche — j’ai déterminé toute une série de valeurs telles que “tuto”, “billet”, “domaine”, “article”, etc. Cela me permet de lister « tous les tutos », par exemple. * le `status` de la fiche — une convention que je me suis donnée, qui me permet de lister les fiches « écrites », « en cours d’élaboration » ou « en germe », etc. ……………………………………………………………………………… Voici ==ce qu’il faut savoir== pour bien utiliser ce bloc de métadonnées : * Les métadonnées sont délimitées par deux lignes de trois tirets `---`, une en dessus et une en dessous. * Ce bloc de métadonnées doit être le premier élément de texte de la fiche. Il peut être précédé et suivi d’autant de lignes vides qu’on veut. * Chaque métadonnée a un nom (une “key”) suivi de `:` (deux points). * On peut mettre autant d’espace que l’on veut après les deux points, avant le contenu-même de la métadonnée. C’est utile pour l’alignement et la lisibilité. * Il y a 3 “keys” et leurs alias qui sont prédéfinis par *Obsidian* : 1. `tags` (ou `Tags:` ou `tag:` ou `Tag:`, à votre convenance ; mais c’est `tags:` que je recommande) — Comme son nom l’indique, il est destiné à accueillir le ou les tags que vous jugerez utiles ou pertinents. 2. `aliases` — sert à attribuer un ou des noms alternatifs pour la fiche, nom(s) que l’on pourra utiliser dans des *wikilinks*, ailleurs dans la base. Pour en savoir plus ⭢ [aide en ligne](https://publish.obsidian.md/help/How+to/Add+aliases+to+note) 3. `cssclasses` — pour activer, au niveau de la fiche courante, un snippet de “code CSS”. C’est un peu “geeky”, mais ça peut rendre service pour modifier l’affichage de la fiche courante. * Plus quelques autres qui servent dans les coffres publiés via *Obsidian Publish*. Je vous laisse découvrir [la documentation officielle](https://help.obsidian.md/Editing+and+formatting/Properties#Properties+for+Obsidian+Publish) pour en savoir plus. (C’est en bas de la page.) * En dehors de ces clefs prédéfinies, on peut laisser libre cours à sa créativité. Quelques exemples de métadonnées utiles : * `auteur` * `source` — le livre ou l’article auquel la fiche fait référence * `lien` — le lien vers une vidéo, par exemple * `nature` — de quel genre de fiche s’agit-il ? (projet, liste, data, kanban, info…) * `status` — l’état d’avancement d’un manuscrit (draft, revision, final…), ou de publication d’un billet sur un blog (draft, published, project…) * La casse (*minuscules* / *majuscules*) n’importe pas, dans tout ce bloc de métadonnées. Cependant, le bon usage informatique veut que le nom des variables commence par une *minuscule* ⭢ préférer `nature` à `Nature` Et c’est une bonne idée d’être systématique : par exemple, tout écrire en **minuscules**. * Il y a une préférence globale pour afficher ou pas ces données “YAML” dans la vue *lecture* (“reading view”). Elle se trouve ici : `Settings > Editor > Display > Properties in document` * Un autre utilisation de ces “Propriétés”, c’est pour y noter des variables utiles à la conversion du document via [[Pandoc]]. Pour en savoir plus : voir [cette page](https://docs.zettlr.com/en/core/yaml-frontmatter/), dans le manuel online de *Zettlr*. * Quand on publie une base sur Internet à l’aide du mécanisme *Obsidian Publish*, ce bloc de “Propriétés” n’est pas publié et donc pas affiché. #### Mon usage Ce que j’ai adopté : * J’aime bien conserver dans la fiche elle-même sa date de création. Comme il n’est pas nécessaire que cette date soit visible en mode *lecture*, elle a tout naturellement sa place dans les “Propriétés”, comme montré ci-dessus. * De temps en temps, le champ `alias:` m’est utile. J’y mets, par exemple, un nom raccourci de la fiche, ce qui me permettra d'y accéder ou de la référencer plus facilement. * `nature:` et `status:` font partie du système que j’ai mis en place qui me permet de lister, grâce au *plugin [[Dataview]]*, « les textes publiés » ou « les fiches à réviser » ou bien encore « les fiches avec idées à développer » ou « les textes en cours de rédaction ». Les possibilités sont infinies. * Dans ce coffre qui me sert à la publication en ligne, le champ `publish:` est très précieux. * J’utilise ce coffre également pour mes « gros projets d’écriture ». Je suis en train d’écrire un livre et je peux séparer, via les métadonnées, la gestion des fiches de ce livre et la gestion des fiches du jardin numérique. * Quant au champ `hideMetadata`, il me sert à afficher ou cacher les métadonnées dans la vue *lecture*. Typiquement, j’aime bien les voir sur les fiches “wip” (“work in progress”), mais je n’ai pas besoin de les voir sur les fiches ordinaires ou sur les fiches “OK”. > [!info]- Pour les geeks” > Techniquement, ce bloc de métadonnées est un bloc YAML — il n’est absolument pas nécessaire de le savoir pour en faire bon usage. > “YAML” est l’acronyme de “Yet Another Markup Language”, ou de “YAML Ain’t a Markup Language” ; c’est de l’humour d’informaticien ! 😉 > Il s’agit d’une manière standardisée d’écrire des métadonnées « en clair » en haut d’un fichier en texte pur. Ce standard est utilisé dans beaucoup de contextes informatiques et *Obsidian* l’a adopté à son tour. J’apprécie cette philosophie qui consiste à ne pas réinventer la roue et à adopter des solutions éprouvées et des standards. &emsp; <a href="https://dr-spinnler.ch"><img src="https://dr-spinnler.ch/myfiles/logos/Olivier-Spinnler.png" class= "signature"/></a> le 2 février 2025 &emsp; ---------------------------------------------- [[tutoriel d’Obsidian]] #informatique #software #Obsidian