Skip to content

DITA Bootstrap v6 - #322

Draft
jason-fox wants to merge 104 commits into
dita-bootstrap:developfrom
jason-fox:v6
Draft

DITA Bootstrap v6#322
jason-fox wants to merge 104 commits into
dita-bootstrap:developfrom
jason-fox:v6

Conversation

@jason-fox

Copy link
Copy Markdown
Collaborator

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
jason-fox marked this pull request as draft August 1, 2026 11:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file documentation enhancement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant