search

boostorg / website-v2-docs

Boost Site Documentation
https://docs.cppalliance.org
Boost Software License 1.0
6 stars 22 forks source link

antora-ui: Contents panel showing even when turned off #319

Closed vinniefalco closed 1 week ago

vinniefalco commented 2 weeks ago

When the playbook or attributes of an antora documentation site specify no Contents, an empty panel is still shown:

https://860.urlantora.prtest2.cppalliance.org/site/url/reference/boost/urls/authority_view.html

image

alandefreitas commented 2 weeks ago

In which playbooks (sitedocs / libs) should we enable/disable the contents panel?

vinniefalco commented 1 week ago

I don't like Contents anywhere, as it appears to be a waste of horizontal space. If a Boost library author wants to turn it on for their Antora-based documentation, then they may do so.

alandefreitas commented 1 week ago

then they may do so.

That's why I ask. They may not. There's no mechanism to replace the UI bundle or UI bundle parameters for a single component.

vinniefalco commented 1 week ago

Sorry, I'm not being clear. What I mean is this: if there is a strong desire by other authors to have the Contents panel in their Antora documentation, then we should bring it back but with a way to configure it on or off, defaulting to off. For now I want to just rip it out and never see it again.