⌨️ Accessibility#

Breeze is designed with accessibility in mind, following web accessibility best practices.

Features#

  • Skip to content: A skip link appears on focus, allowing keyboard users to bypass navigation

  • Semantic HTML: Proper heading hierarchy, landmarks, and ARIA attributes

  • Keyboard navigation: All interactive elements are keyboard accessible

  • Color contrast: High contrast color schemes for both light and dark modes

  • Focus indicators: Visible focus states for keyboard navigation

  • Responsive text: Content scales with browser zoom settings

Keyboard shortcuts#

Shortcut

Action

Ctrl+K / Cmd+K

Open search

Screen readers#

The theme uses ARIA landmarks and labels to help screen reader users navigate:

  • <header> for site header

  • <nav> for navigation regions

  • <main> for primary content

  • <aside> for sidebars

  • <footer> for site footer

High contrast styles#

Breeze uses the accessible-pygments package for syntax highlighting, providing WCAG AA compliant color contrast in code blocks.

Configure syntax highlighting styles in conf.py:

pygments_light_style = "a11y-high-contrast-light"
pygments_dark_style = "github-dark-high-contrast"