Skip to main content

Module title

Module title 

Source
Expand description

Title index — the derived name → document map that resolves nominal (“alias”) references like [[My File]].

This is a derived cache in DESIGN §5’s sense: rebuildable from a scan of the workspace, never authoritative. A nominal link addresses a document by its title (or, failing that, its file stem) rather than by a path or a stable id — the readable-but-fallible option on the identity spectrum (see docs/reference-styles.md). Because titles are neither unique nor stable, a name can resolve to exactly one document, to several (ambiguous — a nominal link cannot choose), or to none.

Structs§

TitleIndex
A name → document(s) index built by scanning a workspace. Names are the documents’ title fields and their file stems; a document is registered under both so [[My File]] (by title) and [[my-file]] (by stem) both find it.

Enums§

TitleMatch
The outcome of resolving a name against a TitleIndex.

Functions§

is_alias_shaped
Whether target is shaped like a nominal reference — a single bare name, with no path separator and no file extension (My File, intro), as opposed to a path (notes/a.md, README.md) or a scheme’d id. Only such targets are looked up in the title index; everything else resolves as a path.