40 lines
3.1 KiB
Markdown
40 lines
3.1 KiB
Markdown
---
|
||
tags: maturity/experimental
|
||
references:
|
||
- plugs/object-graph/*
|
||
---
|
||
|
||
An interactive object-graph explorer visualizes [[Object|objects]] (pages, items, blocks) and the typed [[Object/relation|relations]] between them — letting you navigate your space by structure rather than by name.
|
||
|
||
# Commands
|
||
* ${widgets.commandButton("Graph: Explore")} (`Ctrl/Cmd-Shift-G`): Opens an exploratory graph anchored on the currently open page. Its 1-hop neighborhood is loaded immediately, expand more by clicking ghost nodes.
|
||
* ${widgets.commandButton("Graph: Global Page Map")}: Loads every content page in the space and the `mention` relations between them, all pre-expanded. Useful for a bird's-eye view; toggle other relation labels on from the sidebar to bring in further edges without a refetch.
|
||
|
||
# Interacting with the graph
|
||
* **Click a translucent (ghost) node** to expand its 1-hop neighborhood into the graph.
|
||
* **Click an expanded (solid) node** to select it — its attributes appear in the sidebar’s Object section.
|
||
* **Double-click any node or edge** to navigate to its definition.
|
||
* **Hover an edge** to see its label and snippet.
|
||
* **Drag** a node to pin it, the layout reflows around it.
|
||
* **Hover** a node to dim everything outside its neighborhood.
|
||
* **Scroll / pinch** to zoom; drag empty space to pan.
|
||
* **`Esc`** or the `×` button closes the modal.
|
||
|
||
# Panels
|
||
* **Header** — buttons for **Expand** (open every visible ghost in one batch), **Collapse** (reset the explored set to the selected object + its 1-hop), and a **Hide labels** checkbox to suppress edge labels on dense graphs.
|
||
* **Sidebar**
|
||
* **Root tags** — toggle visibility by structural object kind.
|
||
* **Tags** — toggle visibility by user [[Tag]]. Untagged objects share an `(untagged)` bucket.
|
||
* **Relations** — toggle [[Object/relation|relation]] labels (`mention`, `co-mention`, custom relation types e.g. `spouse`, `team`). `co-mention` is hidden by default in Explore mode; only `mention` is visible by default in Global Page Map mode.
|
||
* **Object** — the selected node's full indexed attributes rendered as YAML. Click the title to navigate to the object. The `×` button (or `Delete` / `Backspace` while the node is selected) removes the node from the graph.
|
||
|
||
Each filter section has `all` / `none` shortcuts, a search box when the list is long, and shows counts from the current graph.
|
||
|
||
# Visual conventions
|
||
* **Solid circles** — expanded nodes (their 1-hop neighborhood is loaded).
|
||
* **Translucent circles** — ghost nodes, click to expand.
|
||
* **Dashed outline** — dangling refs (referenced by some relation but not yet indexed — see [[Aspiring Pages]]).
|
||
* **Color** is driven by the node’s primary user tag, auto-derived from the tag name. Untagged nodes use a neutral gray.
|
||
* **Edge labels** are the relation `kind` (a reserved value like `mention`, or a user predicate like `spouse`), drawn along the edge. Directed edges carry an arrowhead at the target; relations that connect the same pair in both directions get arrows at both ends; collapsed `co-mention` pairs are rendered undirected.
|
||
|
||
The graph is powered entirely by the [[Object/relation]] index. |