DataBook is a document format for semantic documents — Markdown files that carry typed RDF/SPARQL/SHACL payloads alongside human-readable prose and self-describing YAML frontmatter.
Namespace: https://w3id.org/databook/ns#
The canonical CLI implementation of DataBook lives at kurtcagle/databook.
This repository (w3c-cg/holon) previously vendored two separate, independently
drifting copies of that implementation. Both have been removed in favor of a single
upstream source — see Migration Note below.
git clone https://github.com/kurtcagle/databook.git
cd databook
npm install -g .
# or: node bin/databook.js <command>
Requires Node.js ≥ 18.0.0 (uses native fetch).
For installation details, command reference (head, push, pull, process,
validate, and others), configuration (processors.toml), authentication, and
exit codes, see the kurtcagle/databook README.
Spec text or CG artifacts that need to cite implementation behavior as of a specific
point should reference a tagged release of kurtcagle/databook rather than
main, e.g.:
Reference implementation:
kurtcagle/databook@v1.5.1
This keeps the spec’s implementation citation stable even as the CLI continues to evolve.
processors.toml, exit codesAs of 2026-07, this directory no longer vendors a runnable copy of the DataBook CLI. Two copies previously existed here:
architectures/databook/{lib,commands} — an incomplete mirror (lib/ contained
only compact.js; the rest of what commands/*.js imported didn’t exist in this
tree, so it could never actually run).architectures/databook/implementations/js/ — a complete but older, independently
diverged copy of the same CLI.Neither reliably reflected the current state of the implementation, and fixes made to one didn’t propagate to the other or to upstream. Both are retired; the single source of truth is kurtcagle/databook.