doc: imitate unordered bundle to recover tocs#519
Merged
Conversation
|
An automated preview of the documentation is available at https://519.graph.prtest3.cppalliance.org/index.html If more commits are pushed to the pull request, the docs will rebuild at the same URL. 2026-07-01 08:05:36 UTC |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The current documentation pipeline has two problems:
Before submitting
developbranch.Type of change
Does this PR introduce a breaking change?
What this PR does
page-toc: ' 'under asciidoc.attributes.Motivation
Graph's docs put their collapsible-nav fix in a supplemental_files overlay and the right-rail page-toc attribute in the playbook, but Antora only ships UI partials from the site-level ui.bundle and neither overlays nor playbook attributes travel with the component, so any deploy not running Graph's own playbook dropped both (no folding left ToC, no right nav). The fix was to imitate Boost.Unordered: point the playbook at a self-hosted bundle that bakes those behaviors in (unordered-ui-bundle), delete the overlay, and move page-toc into antora.yml where it travels with the component.
Testing
Can't test without merging on develop.
Checklist
b2in thetest/directory).