DITA Bootstrap v6

[jason-fox]

The v6 branch updates the dita-bootstrap DITA-OT plugin to establish compatibility with Bootstrap 6.0. The major changes include renaming components, adopting new responsive utilities syntax, and updating color styles.

---

1. Component Renames & Migrations

Bootstrap 6 deprecates the custom Offcanvas JavaScript component in favor of native CSS/HTML drawer-like elements.

• XSL Templates: offcanvas.xsl has been renamed to drawer.xsl.
• Specialization Classes: Element mappings matching bootstrap-d/offcanvas now produce .drawer instead of .offcanvas classes.
• Sample Files: sample/offcanvas.dita was removed and replaced by sample/drawer.dita.

2. Tailwind-Style Breakpoint Syntax

Bootstrap 6 adopts a colon-separated syntax for responsive breakpoint utilities, matching Tailwind CSS convention. The XSL stylesheets have been updated:

• Display Helpers: Changed from d-none d-lg-block to d-none lg:d-block.
• Margins & Paddings: Changed from my-lg-0 to lg:my-0 and px-sm-1 to sm:px-1.
• Containers: Changed from container-xl to xl:container.

3. Styling & Color Utility Updates

• Subtle Colors: Class names for subtle background variants have changed order (e.g., from bg-primary-subtle to bg-subtle-primary).
• Table Stripes: Updated table template configurations to align with the new Bootstrap 6 table utilities.
• Accessibility Navigation: Skip links and responsive topbars updated to utilize the new layout breakpoints.

[jason-fox]

There are breaking changes between v5 and v6 - you can see the differences here:

https://jason-fox.github.io/dita-bootstrap.html/v5/
https://jason-fox.github.io/dita-bootstrap.html/v6/

There is a CORS issue with the importmap at the moment - this should resolve once the library is available on a proper CDN, this means that if the search plugin is enabled various other toggles won't work (like menu dropdowns). The current CI set-up on my fork has a working search dialog and broken menus.

Obviously the bootswatch themes are also non functioning.