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§
- Title
Index - A
name → document(s)index built by scanning a workspace. Names are the documents’titlefields and their file stems; a document is registered under both so[[My File]](by title) and[[my-file]](by stem) both find it.
Enums§
- Title
Match - The outcome of resolving a name against a
TitleIndex.
Functions§
- is_
alias_ shaped - Whether
targetis 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.