Enum IdStorage 

pub enum IdStorage {
    Registry,
    Frontmatter,
    FrontmatterOnly,
}

Where a document’s stable ID is persisted — the identity-storage axis (DESIGN §5). Orthogonal to when an ID is minted (prov’s Registration) and to how references are spelled; this is purely the ID’s home.

Variants

Registry

Registry only (registry): IDs live solely in the registry document — authoritative, non-derivable, resolved by direct lookup. The cleanest documents (no id clutter), but identity does not travel with a file.

Frontmatter

Frontmatter + registry (both, the default): each document also carries its own ID in an id frontmatter field (a portable, self-describing shadow), and the registry is retained as a rebuildable cache + tombstone ledger. The ID travels with the file across copies and out-of-band moves.

FrontmatterOnly

Frontmatter only (frontmatter): the id field is the sole home; no registry document is written and resolution rebuilds the id→path map by scanning frontmatter. Maximally self-describing, but it forfeits tombstones (a deleted file takes its ID with it), so an ID can in principle be reminted.

Implementations

impl IdStorage

pub fn stamps_frontmatter(self) -> bool

Whether this mode writes the ID into each document’s id frontmatter.

pub fn keeps_registry(self) -> bool

Whether this mode keeps a registry document (the authoritative store, or — under Frontmatter — a rebuildable cache).

pub fn from_config_str(value: &str) -> Option<Self>

Parse the id_storage config spelling; unknown → None. both is the frontmatter+registry default; frontmatter is the registry-less mode.

pub fn as_config_str(self) -> &'static str

The id_storage config spelling.

Trait Implementations

impl Clone for IdStorage

fn clone(&self) -> IdStorage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for IdStorage

impl Debug for IdStorage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for IdStorage

fn default() -> IdStorage

Returns the “default value” for a type.

impl Eq for IdStorage

impl PartialEq for IdStorage

fn eq(&self, other: &IdStorage) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for IdStorage