Feat: Multi-repo navigation *without* widget, *with* categories on left nav
Feat Request
From what I can tell from evaluating, when I list repos in the yaml manifest file, it'll list all repos except 1 in the main doc, the rest going to the widget.
Component A, can be accessed via the component selector menu (aka component drawer) at the bottom of the menu on the left side of the page.
If I have 50 repos, where I want to group them the way I want to as if it's 1 cohesive doc (think Unity's docs where they have the Macro version up top to select, then all their individual components as if it's 1 doc).
If Unity pulls from 500 different repos, they don't stuff it into a widget; instead, they group them on the left navigation and allow nesting into groups.
- A
- A1 - Some repo related to A
- A2 - Some other repo related to A
- B
- C
Instead, Antora defaults to:
- A ....widget[A, A1, A2, B, C] in a flat structure, each independently listed in just a spam of uncategorized choices.
If you support something similar to how Unity or Unreal docs for navigation styles, this would do wonders for the tech world - those writing technical documentation for software with iterative releases across multiple repos.
Let's say I release v1.0.0 -- I want it grouped with A's v1.5.1 and B's v2.1.1. A snapshot in time with all components working together.
In a manifest file, I'd have something like:
- v1.0.1 (whatever's listed first would be the default version)
- Repo url is listed here
- Repo version tag listed here to be grouped with macro release v1.0.1
- Repo url is listed here
- v1.0.0 (archive, useful to show in your bottom-left widget)
- Repo url is listed here
- Repo older version tag listed here to be grouped with macro release v1.0.0
- Repo url is listed here
This is a bit hard to explain, but again, like Unity docs + Unreal docs: A macro version with their subrepo doc versions tied to the macro version with the ability to organize them in the main navigation (rather than a flat list). I bet others use this form, too.
Another example, let's say I have 3 repos related to 1 topic:
// Macro version v1.0.1, selected via dropdown or default since it's the latest ver at the top
- Quickstart Guide
- JS // Pulled from its own repo tag v5.5.5
- TS // Pulled from its own repo tag v3.2.1
- C# // Pulled from its own repo tag v6.6.5
In Antora, from what I can see, these 3 language guides would simply be nested flatly in the widget with only 1 of them showing at a time. So, instead, I'd see:
- JS // That's it
[Widget with the others flatly crammed in, completely detached and unable to nest it under a group on the left navigation]
I'm still new to evaluating Antora, so I could be mistaken on some parts - do correct me, if so!
TL;DR
Like Unity Docs: Is there a way to have multiple repos grouped in the same nav bar (not the widget, and organized to groups) on the left nav bar? Rather than flatly stuffed into the widget?