{"repo":"gsemet/okf-schema","free":true,"listed":false,"github":"https://github.com/gsemet/okf-schema","clone":"git clone https://github.com/gsemet/okf-schema.git","description":"Open Knowledge Format with JSONSchema","language":"Python","stars":14,"topics":["cli","frontmatter","jsonschema","knowledge-base","markdown","okf","python","yaml"],"license":"MIT","category":"cli-tools","readme_excerpt":"okf-schema okf-schema is a CLI tool and Python library for working with OKF (Open Knowledge Format) bundles with JSONSchema validation of the frontmatter metadata, and formatting capabilities while preserving comments. OKF is a markdown-based knowledge format where each concept is a markdown file with YAML frontmatter. See the OKF specification for the full format definition. 📚 Full documentation : okf-schema.readthedocs.io [!IMPORTANT] OKF-schema is opinionated. It delivers a valid OKF bundle but is adds a structure on the frontmatter that is not allowed in OKF specification: In a strict OKF bundle, the type field is mandatory but can take any value and the validator needs to allow any field in the frontmatter. OKF-schema requires the type to be one of the registered types in the schema/ directory and validates the frontmatter against the corresponding schema. Additional properties may or may not be allowed depending on the schema definition. What okf-schema adds to OKF Plain OKF only defines a folder of markdown files. okf-schema turns those files into a validated, queryable knowledge base by adding: Capability What it does ----------- -------------- Schema-driven frontmatter validation Every concept's YAML frontmatter is checked against a JSONSchema. Invalid fields, missing required keys, or wrong types are reported as structured errors. Auto-discovered schemas Schemas live inside the bundle under schema/ (e.g. schema/concept.schema.yaml ). The type field in a concept's f","default_branch":null,"files":null,"tree":[],"storefront":"/r/gsemet","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/gsemet/okf-schema/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}