AV-75840 top nav highlight

[osfameron]

This PR adds a highlight to the top nav for which section we're in:

You can currently see it in action on Staging:

The logic used is:

• check the Nav Groups (defined in antora-playbook.yml e.g. https://github.com/couchbase/docs-site/blob/master/antora-playbook-staging.yml#L22-L29 )
• if the current component matches the components key, then it's highlighted
• but also the "index pages" like https://docs-staging.couchbase.com/home/sdk.html are in the home component...
  So we ALSO need to check if the url matches the page
• this means that the home component has to have special handling, where we check if it (and ONLY it) could be highlighted

[sarahlwelton]

I don't see any of the duplication behaviours on the preview site that you've provided anymore, and the spacing looks to be what I'd expect. I can 👍 this if we want to get it merged, or we can wait for further comments.

[sarahlwelton]

Just curious if this still works as expected with replacing the #with helper?

[osfameron]

yes! So with is basically an if but with scoping.

So {{{@root.site.url}}}{{{this}}}
relied on that behaviour + and's behaviour (or returning the second truthy value on success) which honestly is a bit "cute" to understand.

This refactor just makes the logic a bit more explicit.

[osfameron]

Deployed the contribute/style-guide nav changes to Staging and looks like this logic does NOT work for that:
e.g. https://staging.docs-test.couchbase.com/home/contribute/index.html

Is this a blocker? (e.g. getting to the writer's guide is something you generally don't do by accident, so not sure if this needs to delay pushing it out?)

[sarahlwelton]

Deployed the contribute/style-guide nav changes to Staging and looks like this logic does NOT work for that: e.g. https://staging.docs-test.couchbase.com/home/contribute/index.html

Is this a blocker? (e.g. getting to the writer's guide is something you generally don't do by accident, so not sure if this needs to delay pushing it out?)

What would we even expect to highlight in the top nav for this? The home icon?

I honestly think it's negligible and not a blocker. We care more about the actual product highlighting, not highlights for something that's largely supposed to be internal.

[osfameron]

Thanks @sarahlwelton, that makes sense.
I was thinking of it as part of "Home" because that's where this kind of content used to be, but now it's not even really that technically.

(Is a little odd that the old Writer's Guide content, under /home/contribute doesn't trigger it, but would arguably be weirder if only that one section did)