Handbook
This handbook covers the nanopublication ecosystem topic by topic, from nanopublications themselves to identities and trust, spaces and roles, templates, queries, and views.
It is a copy of the Nanopublication Docs, which are themselves published as nanopublications: each of its 155 paragraphs is one. Members of the nanopub space write and edit them in Nanodash, and this website is updated from there.
Topics
- Nanopublication — What a nanopublication is: its four parts, its content-based identifier, its signature, and why it never changes once published.
- Nanopublication versions and retractions — How a nanopublication is replaced or withdrawn, why only the same key counts, and how deriving and overriding let others build on or revise it.
- Person — Who you are on the network: your ORCID, your signing key, your introduction, and what approval means for you.
- Trust and approval — How the network decides whose keys count: seeds, approvals, rounds, and what being pending or skipped means.
- Space — Collaborative units on the network: creating a space, its admins and roles, sub-spaces, maintained resources, and what its page shows.
- Space member role — Roles in a space: tiers, defining and attaching roles, granting and revoking them, and what a role gives its holder.
- Maintained resource — Things a space takes responsibility for: declaring them, namespaces and parts, who may do what, and shared definitions.
- Vocabulary — Vocabularies as maintained resources: defining terms, approving them, changing them, and releasing versions.
- Software agent — Bots and tools that publish under their own identity: keys, introductions, approval, joining a space, publishing as the agent.
- Nanopublication template — Templates that describe the shape of a nanopublication: statements, placeholders, resources, versions, settings, and fill modes.
- Nanopublication query template — Query templates in the grlc style: placeholders, parameters, result columns, testing and the rules for writing them.
- Query endpoints and repositories — The repositories a query can run against: full, meta, text, per-type, per-key, spaces and trust, and how to combine them.
- Resource view — Views that make up the pages of spaces, people and resources: kinds, queries, placement, versions, and making one.
- View action — Buttons on views that open pre-filled forms: result and entry actions, visibility, mappings, fill modes and fill queries.
- View display — Attaching a view to a page, turning it off, adjusting it for one page, and views for the parts of a resource.
- Preset — Bundles of views and roles assigned to a resource: assigning, versions, and how presets and displays combine.
- Nanopublication types and labels — How a nanopublication's types and label are found, why they matter, and when to state them explicitly.
- Nanopublication index — A nanopublication that lists other nanopublications: size, chaining, and making one.
- Protected nanopublication — Nanopublications that stay on a local registry and never reach the public network: marking, routing, and expectations.
- Documentation topic — How this documentation is made and how to contribute: topics, paragraphs, editing, ordering, examples and related paragraphs.