Skip to content

DITA Bootstrap v6 - #14

Draft
jason-fox wants to merge 12 commits into
developfrom
v6
Draft

DITA Bootstrap v6#14
jason-fox wants to merge 12 commits into
developfrom
v6

Conversation

@jason-fox

Copy link
Copy Markdown
Collaborator

The v6 branch updates the specialization plugin to enforce DITA-OT validation (via DTDs) matching the new schema requirements and component definitions of Bootstrap 6.


1. DTD Element Migrations (Offcanvas to Drawer)

To align with Bootstrap 6 retiring the Offcanvas JS component for native Drawer components:

  • Entities Updated (bootstrapDomain.ent):
    • Replaced offcanvas with drawer in the base entities:
      <!ENTITY % drawer "drawer">
    • Updated bootstrap-d-section content model:
      <!ENTITY % bootstrap-d-section "accordion-item | alert | card | drawer | pagination">
  • Declarations Updated (bootstrapDomain.mod):
    • Deleted the <offcanvas> element definition.
    • Declared the new <drawer> element and its attributes:
      <!ELEMENT drawer (%drawer.content;)>
    • Mapped the class hierarchy:
      <!ATTLIST drawer class CDATA "+ topic/section bootstrap-d/drawer ">

2. Updated Color Palettes (Light/Dark $\rightarrow$ Accent/Inverse)

Bootstrap 6 deprecates the light and dark utility classes, replacing them with the semantically flexible accent and inverse values.

  • Main Elements & Utilities (bootstrapDomain.mod & bootstrapCommonElements.mod):
    • The color attribute on badge, button, card, carousel, list-group, drawer, popover, tabbed-dialog, tooltip, thumbnail, and note was updated:
      • Old: (primary | secondary | success | danger | warning | info | light | dark)
      • New: (primary | secondary | success | danger | warning | info | accent | inverse)
  • Borders & Decoration attributes:
    • Updated border colors to use the new naming convention, including the new subtle variants:
      • Old: light-subtle | dark-subtle
      • New: accent-subtle | inverse-subtle

3. Sample Document Updates

The sample files packaged with the plugin were fully updated to replace references to the deprecated features:

  • sample/offcanvas.dita has been removed and replaced by sample/drawer.dita to document the new specialization element.
  • Samples like alerts.dita, badge.dita, buttons.dita, color.dita, and shadows.dita were refactored to use the new accent, inverse, accent-subtle, and inverse-subtle attributes instead of the legacy light/dark properties.

@jason-fox
jason-fox marked this pull request as draft August 1, 2026 11:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant