Relationship Graph
Table of Contents
Goosequill includes a relationship graph for showing links between posts, pages, tags, and wiki-style references.
As the site grows, pages are often connected by more than time or tags. The graph puts related pages on one map, so readers can continue browsing through context.
If you are setting up Goosequill for the first time, start with Quick start.
What It Does
Besides article lists, pagination, and tag pages, the graph shows nearby pages directly. Readers can click nodes to move between related content.
It supports:
- full-site graph view
- local graph view around the current article
- node search
- zoom and reset controls
- localized page navigation
There are two common views:
- Global view: shows relationships across the whole site
- Local view: shows the current article and nearby pages
How To Use It
The full graph page gives a broad view of the site. It is useful when someone wants to scan the shape of the archive, search for a topic, or jump between related clusters.
Inside an article, the local graph narrows the view to the current post and its neighbors. That smaller view is better for reading because it shows what came before, what points forward, and what belongs nearby without forcing the reader away from the page.
The expanded modal keeps the same local context but gives the graph more room. It preserves the current focus, supports zooming and resetting, and can be closed without losing the article.
Data Source
The graph is generated from Astro content collections and rendered as SVG on the client. Posts, pages, tags, and wiki links are included in the graph data.
English and Chinese routes receive separate graph data, so pages from different languages are not mixed into one graph.