Plainva

OKF — Open Knowledge Format

Laatst bijgewerkt: 2026-07-11

OKF (Open Knowledge Format) is een open conventie voor Markdown-kenniscollecties: pure Markdown-bestanden met een kleine, uniforme frontmatter-kop. Deze pagina legt uit wat OKF is, wat Plainva daarvoor automatisch doet — en waarom je er niets van hoeft te gebruiken.

Wat is OKF?

Het idee: elk document in de vault zegt zelf wat het is. Daarvoor volstaat een minimale kop in de frontmatter:

---
type: Note
okf_version: "0.1"
---
# Mijn notitie

Schrijf je bestanden met een tool of script? Het exacte veldcontract — toegestane waarden, hoe elk eigenschapstype serialiseert, en de regels voor gereserveerde namen — staat in de Bestandsformaat-referentie.

Waarom gebruikt Plainva OKF?

Gewone Markdown is fantastisch draagbaar — maar heeft op zichzelf geen betrouwbare structuur. OKF voegt daar precies genoeg van toe, en alles blijft gewoon Markdown met standaard frontmatter:

Wat Plainva automatisch doet

Nieuwe bestanden krijgen de OKF-kop automatisch: elke in Plainva aangemaakte notitie krijgt type en okf_version in de frontmatter. Welke waarden, stel je per vault in: Instellingen → Vault → Inhoud en structuur → OKF (Open Knowledge Format) → type voor nieuwe notities (standaard Note) en type voor dagelijkse notities (standaard Daily Note). Brengt een sjabloon een eigen type mee, dan wint het sjabloon.

Bestaande bestanden worden nooit ongevraagd gewijzigd. Plainva voegt OKF-velden alleen toe bij het aanmaken van nieuwe bestanden of wanneer je de conversie expliciet start.

Beschermde systeemvelden: in het paneel Eigenschappen zijn type en okf_version gemarkeerd als OKF-systeemvelden (“OKF-systeemveld – wordt beheerd door Plainva”): de type-waarde is kiesbaar uit een vervolgkeuzelijst met bekende typen, okf_version is alleen ter weergave; hernoemen, typewijziging en verwijderen zijn vergrendeld zodat de conventie niet per ongeluk kan breken.

Het uitlegvenster: Wat is OKF? in de instellingen geeft je de korte versie in drie zinnen plus een link naar deze pagina. Het opent niet meer vanzelf; bevat een vault bestanden die niet aan het OKF-formaat voldoen, dan meldt Plainva dat eenmalig in een klein bericht met een knop die je direct naar de conversie brengt.

index.md: de inhoudsopgave per map

Een index.md is de inhoudsopgave van een map: een lijst van de bevatte notities en submappen, met beschrijvingen en relatieve links.

Een bestaande vault converteren (opt-in)

Als bestanden in de vault niet voldoen aan het OKF-formaat (ontbrekend type-veld, of gereserveerde namen gebruikt als gewone notitie), biedt Plainva de conversie aan — eenmalig bij het openen van de vault en permanent onder Instellingen → Vault → Inhoud en structuur (het item verschijnt alleen zolang er iets te doen is).

De wizard Naar OKF-formaat converteren werkt in duidelijke stappen:

  1. Scannen — toont hoeveel bestanden zijn betrokken (sjabloon- en systeemmappen zijn uitgezonderd; bestanden met onleesbare frontmatter worden overgeslagen, nooit “gerepareerd”).
  2. Beslissingen — een standaard-type voor bestanden zonder één; bestaande type-waarden kun je behouden (aanbevolen — ze zijn al geldige OKF-typen) of hernoemen naar een ander veld.
  3. Voorbeeld (geen wijzigingen) — een dry run toont vooraf wat er zou veranderen.
  4. Converteren — van elk bestand wordt vóór de wijziging een back-up gemaakt naar .plainva/backups/; een rapport vat samen wat er is gewijzigd, overgeslagen en waar de back-upmap staat. Daarna kun je optioneel verdergaan naar het index.md-beheer.

Een tip uit de wizard: wijzigingen lopen zoals gebruikelijk via de synchronisatie — bij git-vaults eerst committen.

Moet ik OKF gebruiken?

Nee. OKF is een zachte standaard:

Zie ook