✨ Site Nav from tag graph

[ikesau]

Removes the hardcoded SiteNavigationStatic object that powered the site nav and replaces it with a JSON file representation of the tag graph from the database.

As a reminder, the tag graph shape is:

interface TagGraphNode {
    children: TagGraphNode[]
    id: number
    isTopic: boolean
    name: string
    path: number[]
    slug: string | null
    weight: number
}

[owidbot]

Quick links (staging server):

Site Dev	Site Preview	Admin	Wizard	Docs

Login: ssh owid@staging-site-sitenav-from-tag-graph

• Site-screenshots: https://github.com/owid/site-screenshots/compare/sitenav-from-tag-graph
• SVG tester: https://github.com/owid/owid-grapher-svgs/compare/sitenav-from-tag-graph

SVG tester:

Number of differences (default views): 0 ✅
Number of differences (all views): 0 ✅

Edited: 2025-01-13 22:01:06 UTC
Execution time: 1.25 seconds

[ikesau]

Technically we don't need to fetch the topicTagGraph.json when we're on the homepage, because it's already embedded in the homepage gdoc's homepageMetadata, but seeing as the JSON request is ~4kB transferred, I think it's okay to not optimize.

Later, we should see if it's possible to get this file and dods.json to cache.

[mlbrgl]

nice to see the merging of tag and topics taking shape more visibly!

It seems like the order of tags in the graph is a bit arbitrary at the moment on live, are we waiting for authors to reorder before merging?

[ikesau]

This is a rename of SiteMobileCategory - if you omit the commit where that change was made, you can see the actual changes to the file I made

[ikesau]

Hey @mlbrgl - thanks for taking another look at this - the main difference is the flattenNonTopicNodes function and ensuing integration work. I wrote some very basic tests for it to help document what it does. The difference that you'll notice on staging is that the homepage all-topics section now has sub areas again, and topics in the site nav are correctly ordered/grouped.

[mlbrgl]

a couple of very minor comments, everything looks good!

[mlbrgl]

not sure about the design here but we had a ":" after subarea names.

Incidentally, subareas don't show on staging, but ok on dev (some rebaking/caching shenanigans?)

[ikesau]

Yeah the tag graph on staging doesn't have the latest structure that prod does. It's a pain to re-import, but if I tore down and recreated this staging env it would use the prod data which is correct 👍