Node Rendering
On this page, you can find all the configuration options related to the rendering of nodes in the site graph, both in terms of which nodes are shown and how they are styled.
If you are looking for how an individual node can be styled, check out the node style page.
Render Unresolved Nodes
The renderUnresolved
option toggles the rendering of unresolved nodes in the graph.
When a link goes to a page on the same site which does not exist, the node is marked as unresolved.
Render External Nodes
The renderExternal
option toggles the rendering of external nodes in the graph.
External nodes are links to pages on other sites.
Node Styles
In the site graph plugin, there are 6 types of nodes that can exist in the graph:
- Default (base style)
- External (nodes refers to pages on other sites)
- Visited (user has visited the page)
- Tags (node is a tag)
- Current (current page)
- Unresolved (node refers to a page that does not exist)
Each node type can be individually styled using their own style. Also, each subsequent style inherits from the previous style in the list.
An example: a node can be both visited
as well as current
at the same time, the final style for this node will thus be determined as:
- Styles specified by
current
style - Styles specified by
visited
style - Styles specified by
default
style
For information about how these node styles can be configured, see the node style page.
Default
nodeDefaultStyle
is a style applied to all nodes in the graph, each other style applied to a node, overrides this style.
External
nodeExternalStyle
is a style applied to nodes that refer to pages on other sites.
External nodes only appear if the renderExternal
option is enabled in the graph config.
Visited
nodeVisitedStyle
is a style applied to nodes corresponding to pages that have been visited by the user.
Visited nodes only appear if the trackVisitedPages
option is enabled in the general config.
Tags
tagDefaultStyle
is the default style for tags in the graph.
Tags are pseudo-nodes that are created when a page has tags (either via frontmatter or tagRules
).
Current
nodeCurrentStyle
defines the style for the current node in the graph.
The current node corresponds to the page that the user is currently viewing.
Unresolved
nodeUnresolvedStyle
is the style applied to nodes that refer to pages that do not exist.
Unresolved nodes only appear if the renderUnresolved
option is enabled in the graph config.