Plainva

OKF — Open Knowledge Format

Dernière mise à jour : 2026-07-11

OKF (Open Knowledge Format) est une convention ouverte pour les collections de connaissances en Markdown : des fichiers Markdown purs avec un petit en-tête frontmatter uniforme. Cette page explique ce qu’est l’OKF, ce que Plainva fait automatiquement pour lui — et pourquoi vous n’êtes obligé d’utiliser rien de tout cela.

Qu’est-ce que l’OKF ?

L’idée : chaque document du vault dit lui-même ce qu’il est. Un en-tête frontmatter minimal suffit :

---
type: Note
okf_version: "0.1"
---
# Ma note

Vous écrivez des fichiers avec un outil ou un script ? Le contrat de champ exact — quelles valeurs sont autorisées, comment chaque type de propriété se sérialise, et les règles de noms réservés — vit dans la Référence du format de fichier.

Pourquoi Plainva utilise-t-il l’OKF ?

Le Markdown pur est merveilleusement portable — mais à lui seul, il n’a aucune structure fiable. L’OKF en ajoute juste ce qu’il faut, et tout reste du Markdown ordinaire avec un frontmatter standard :

Ce que Plainva fait automatiquement

Les nouveaux fichiers reçoivent l’en-tête OKF automatiquement : chaque note créée dans Plainva reçoit type et okf_version dans son frontmatter. Vous configurez les valeurs par vault : Paramètres → Vault → Contenu et structure → OKF (Open Knowledge Format) → type pour les nouvelles notes (par défaut Note) et type pour les notes quotidiennes (par défaut Daily Note). Si un modèle apporte son propre type, le modèle l’emporte.

Les fichiers existants ne sont jamais modifiés sans votre accord. Plainva n’ajoute des champs OKF qu’à la création de nouveaux fichiers ou lorsque vous démarrez explicitement la conversion.

Champs système protégés : dans le panneau Propriétés, type et okf_version sont marqués comme champs système OKF (« Champ système OKF – géré par Plainva ») : la valeur de type se choisit dans une liste déroulante de types connus, okf_version est en affichage seul ; le renommage, le changement de type et la suppression sont verrouillés pour que la convention ne puisse pas se casser par accident.

Le modal explicatif : Qu’est-ce que l’OKF ? dans les paramètres vous donne la version courte en trois phrases, plus un lien vers cette page. Il ne s’ouvre plus tout seul ; si un vault contient des fichiers qui ne sont pas conformes au format OKF, Plainva le signale une fois dans un petit message avec un bouton qui vous mène directement à la conversion.

index.md : la table des matières par dossier

Une index.md est la table des matières d’un dossier : une liste des notes et sous-dossiers qu’il contient, avec des descriptions et des liens relatifs.

Convertir un vault existant (opt-in)

Si des fichiers du vault ne sont pas conformes au format OKF (champ type manquant, ou noms réservés utilisés comme notes normales), Plainva propose la conversion — une fois à l’ouverture du vault, et en permanence sous Paramètres → Vault → Contenu et structure → Conversion OKF (l’entrée n’apparaît que tant qu’il y a quelque chose à faire).

L’assistant Convertir au format OKF fonctionne en étapes claires :

  1. Analyse — montre combien de fichiers sont concernés (les dossiers de modèles et système sont exclus ; les fichiers avec un frontmatter illisible sont ignorés, jamais « réparés »).
  2. Décisions — un type par défaut pour les fichiers qui n’en ont pas ; les valeurs type existantes peuvent être conservées (recommandé — ce sont déjà des types OKF valides) ou renommées vers un autre champ.
  3. Aperçu (sans modifications) — un essai à blanc montre à l’avance ce qui changerait.
  4. Convertir — chaque fichier est sauvegardé dans .plainva/backups/ avant d’être modifié ; un rapport résume ce qui a changé, ce qui a été ignoré, et le dossier de sauvegarde. Ensuite, vous pouvez éventuellement continuer vers le gestionnaire d’index.md.

Un conseil de l’assistant : les modifications passent normalement par la synchronisation — pour les vaults git, committez d’abord.

Dois-je utiliser l’OKF ?

Non. L’OKF est une norme douce :

Voir aussi