* refactor(a11y): comprehensive WCAG 2.2 AA accessibility improvements
Add skip-to-content link, landmark regions, ARIA attributes, keyboard
navigation, focus styles, reduced-motion support, and i18n keys across
all layouts, partials, shortcodes, and JS components.
- Add skip nav link in baseof.html and id="content" on all <main> tags
- Fix 404 page lang/dir attributes and add <main> landmark
- Add aria-label to banner close, PDF iframe, search input/results
- Remove aria-hidden from back-to-top button
- Add aria-hidden to decorative external link icon
- Add role="tablist" to tabs, aria-expanded to filetree/dropdowns
- Wrap mermaid diagrams in role="img", asciinema in role="region"
- Change theme toggle <p> items to <button role="menuitem"> with
full keyboard navigation (Arrow/Home/End/Escape)
- Add arrow-key keyboard navigation to tabs component
- Separate sidebar collapsible button from link for independent
keyboard access with aria-expanded sync
- Sync aria-expanded on all dropdown toggles (theme, lang, navbar,
hamburger, page context menu)
- Add aria-live search status announcements
- Add 13 new i18n keys, replace hardcoded aria-label strings
- Add prefers-reduced-motion CSS override and focus-visible base styles
- Add aria-label swap on code copy ("Copied!" feedback for AT)
- Add aria-current to active TOC links
- Wrap filetree in <ul> container for proper list semantics
- Add unique aria-label to blog "Read more" links
- Document accessibility guidelines in AGENTS.md
* feat(a11y): enhance focus styles and accessibility for various components
- Add focus-visible styles to badges, buttons, and links for improved keyboard navigation.
- Update breadcrumb, sidebar, and TOC components to include focus-visible outlines.
- Introduce new classes for focus states in the badge and tabs shortcodes.
- Ensure consistent focus styles across all interactive elements to meet WCAG 2.2 AA standards.
* feat(a11y): implement new focus-visible utilities and enhance accessibility styles
- Introduce new utility classes for focus-visible states to improve keyboard navigation.
- Update various components including badges, buttons, and search inputs to utilize new focus-visible styles.
- Refactor existing focus styles to ensure consistency and compliance with accessibility standards.
- Enhance breadcrumb, sidebar, and TOC components with updated focus-visible classes for better user experience.
* chore: add .gitattributes to collapse generated files in PR diffs
* fix: enhance accessibility and improve documentation
- Added alt attributes to images in multiple language documentation files for better accessibility.
- Updated the navbar title partial to remove unnecessary title attribute.
- Improved search input accessibility by adding autocomplete="off".
- Enhanced search partials in both navbar and sidebar with location context.
- Updated SVG icons in various components to include aria-hidden and focusable attributes for improved accessibility compliance.
* fix: improve giscus theme toggle functionality
- Updated the theme toggle options selector to use a data attribute for better specificity.
- Modified the event listener to use a setTimeout for the theme update, ensuring smoother transitions when the theme switcher is clicked.
* fix: resolve axe-core WCAG AA violations across docs pages
Add aria-labels to Hugo task list checkboxes, fix asciinema player
timer accessible names, make Jupyter output cells keyboard-focusable,
and add missing heading hierarchy in shortcodes docs for fa/ja/zh-cn.
* feat: integrate accessibility testing with Playwright and enhance CI workflow
- Added Playwright configuration for accessibility testing.
- Implemented accessibility tests using axe-core for all English pages.
- Created a GitHub Actions workflow to automate accessibility tests on pull requests.
- Updated package dependencies to include @axe-core/playwright and @playwright/test.
- Enhanced sidebar component with data attributes for improved accessibility styling.
* fix: update base URL and improve accessibility labels across multiple languages
- Changed the base URL in Playwright configuration and CI workflow from localhost:3000 to localhost:1313.
- Added accessibility labels for screen readers in various language files, enhancing user experience for visually impaired users.
- Updated the Asciinema script to dynamically set the playback time label for better accessibility compliance.
* refactor: reorganize accessibility tests and update test directory structure
- Moved accessibility tests from the e2e directory to a new tests directory for better organization.
- Updated the test directory path in Playwright configuration.
- Refactored the accessibility test implementation to improve code clarity and maintainability.
* chore: update .gitignore to include Playwright test output directories
- Added entries for 'playwright-report/' and 'test-results/' to the .gitignore file to prevent cluttering the repository with test artifacts.
* refactor: enhance accessibility and improve focus styles across components
- Removed unused utility for focus visibility in CSS and consolidated focus-visible styles for better maintainability.
- Updated various components to use `role` attributes for improved accessibility, including menu items and buttons.
- Enhanced theme toggle and language switch components with appropriate ARIA roles and attributes for better screen reader support.
- Improved the handling of focus states in the navigation and context menus to ensure a consistent user experience.
* chore: update dependencies and enhance accessibility features
- Updated the 'serve' package version in package.json and package-lock.json for improved performance.
- Removed unused 'xml2js' dependency to streamline the project.
- Enhanced the Playwright configuration to better manage the web server setup for testing.
- Improved accessibility in the language switcher and navigation menu by refining focus management and keyboard interactions.
- Updated the back-to-top button to manage tabindex for better accessibility compliance.
* feat: enhance mobile menu accessibility and keyboard interactions
- Added ARIA attributes to manage visibility of the sidebar on mobile devices.
- Implemented focus management for the sidebar when the menu is toggled.
- Introduced keyboard support to close the menu with the Escape key.
- Improved overall accessibility for the hamburger menu and sidebar interactions.
* fix: refine mobile menu keyboard interaction and enhance navbar accessibility
- Updated the Escape key functionality to close the menu only on mobile devices.
- Added a new ARIA attribute to the hamburger menu button for improved accessibility.
148 lines
6.1 KiB
CSS
148 lines
6.1 KiB
CSS
.content {
|
|
:where(h1):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:mt-2 hx:text-4xl hx:font-bold hx:tracking-tight hx:text-slate-900 hx:dark:text-slate-100;
|
|
}
|
|
:where(h2):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:font-semibold hx:tracking-tight hx:text-slate-900 hx:dark:text-slate-100 hx:mt-10 hx:border-b hx:pb-1 hx:text-3xl hx:border-neutral-200/70 hx:contrast-more:border-neutral-400 hx:dark:border-primary-100/10 hx:contrast-more:dark:border-neutral-400;
|
|
}
|
|
:where(h3):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:font-semibold hx:tracking-tight hx:text-slate-900 hx:dark:text-slate-100 hx:mt-8 hx:text-2xl;
|
|
}
|
|
:where(h4):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:font-semibold hx:tracking-tight hx:text-slate-900 hx:dark:text-slate-100 hx:mt-8 hx:text-xl;
|
|
}
|
|
:where(h5):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:font-semibold hx:tracking-tight hx:text-slate-900 hx:dark:text-slate-100 hx:mt-8 hx:text-lg;
|
|
}
|
|
:where(h6):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:font-semibold hx:tracking-tight hx:text-slate-900 hx:dark:text-slate-100 hx:mt-8 hx:text-base;
|
|
}
|
|
:where(p):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:mt-6 hx:leading-7 hx:first:mt-0;
|
|
}
|
|
:where(a):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:text-primary-600 hx:underline hx:decoration-from-font;
|
|
}
|
|
:where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:mt-6 hx:border-gray-300 hx:italic hx:text-gray-700 hx:dark:border-gray-700 hx:dark:text-gray-400 hx:first:mt-0 hx:ltr:border-l-2 hx:ltr:pl-6 hx:rtl:border-r-2 hx:rtl:pr-6;
|
|
}
|
|
:where(pre):not(:where(.hextra-code-block pre, [class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:bg-primary-700/5 hx:mb-4 hx:overflow-x-auto hx:rounded-xl hx:font-medium hx:subpixel-antialiased hx:dark:bg-primary-300/10 hx:text-[.9em] hx:contrast-more:border hx:contrast-more:border-primary-900/20 hx:contrast-more:contrast-150 hx:contrast-more:dark:border-primary-100/40 hx:py-4;
|
|
}
|
|
:where(code):not(:where(.hextra-code-block code, [class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:border-black/4 hx:bg-black/3 hx:wrap-break-word hx:rounded-md hx:border hx:py-0.5 hx:px-[.25em] hx:text-[.9em] hx:dark:border-white/10 hx:dark:bg-white/10;
|
|
}
|
|
:where(table):not(:where(.hextra-code-block table, [class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:block hx:overflow-x-auto hx:my-6 hx:p-0 hx:first:mt-0 hx:w-full hx:text-sm hx:leading-5 hx:border-collapse;
|
|
|
|
thead {
|
|
@apply hx:bg-gray-50 hx:dark:bg-gray-600/20;
|
|
}
|
|
tr {
|
|
@apply hx:m-0 hx:border-t hx:border-gray-300 hx:p-0 hx:dark:border-gray-600;
|
|
}
|
|
th {
|
|
@apply hx:m-0 hx:border hx:border-gray-300 hx:p-2 hx:font-semibold hx:dark:border-gray-600;
|
|
}
|
|
td {
|
|
@apply hx:m-0 hx:border hx:border-gray-300 hx:p-2 hx:dark:border-gray-600;
|
|
}
|
|
}
|
|
:where(ol):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:mt-6 hx:list-decimal hx:first:mt-0 hx:ltr:ml-6 hx:rtl:mr-6;
|
|
li {
|
|
@apply hx:my-2;
|
|
}
|
|
}
|
|
:where(ul):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:mt-6 hx:list-disc hx:first:mt-0 hx:ltr:ml-6 hx:rtl:mr-6;
|
|
li {
|
|
@apply hx:my-2;
|
|
}
|
|
}
|
|
/* Task lists - hide list markers for lists containing checkboxes */
|
|
:where(ul):not(:where([class~=not-prose],[class~=not-prose] *)):has(li input[type="checkbox"]) {
|
|
@apply hx:list-none;
|
|
}
|
|
/* This CSS rule targets the first nested unordered (ul) or ordered (ol) list
|
|
inside the list item (li) of any parent ul or ol.
|
|
The rule sets the top margin of the selected list to zero. */
|
|
:where(ul, ol) > li > :where(ul, ol):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:mt-0;
|
|
}
|
|
:where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:border-black/4 hx:bg-black/3 hx:wrap-break-word hx:rounded-md hx:border hx:py-0.5 hx:px-[.25em] hx:text-[.9em] hx:dark:border-white/10 hx:dark:bg-white/10;
|
|
}
|
|
:where(pre.mermaid):not(:where(.hextra-code-block pre, [class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:bg-transparent hx:rounded-none hx:dark:bg-transparent;
|
|
}
|
|
:where(img):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:mx-auto hx:my-4 hx:rounded-md;
|
|
}
|
|
:where(figure):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
figcaption {
|
|
@apply hx:text-sm hx:text-gray-500 hx:dark:text-gray-400 hx:mt-2 hx:block hx:text-center;
|
|
}
|
|
}
|
|
/* Definition list */
|
|
:where(dl):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
dt {
|
|
@apply hx:mt-6 hx:font-semibold;
|
|
}
|
|
dd {
|
|
@apply hx:my-2 hx:ps-6;
|
|
}
|
|
}
|
|
/* Horizontal line */
|
|
:where(hr):not(:where([class~=not-prose],[class~=not-prose] *)) {
|
|
@apply hx:my-10 hx:first:mt-0 hx:last:mb-0 hx:border-gray-200 hx:dark:border-neutral-800;
|
|
}
|
|
.footnotes {
|
|
@apply hx:mt-12 hx:text-sm;
|
|
|
|
hr {
|
|
@apply hx:border-gray-200 hx:dark:border-neutral-800;
|
|
}
|
|
}
|
|
.subheading-anchor {
|
|
@apply hx:opacity-0 hx:transition-opacity hx:ltr:ml-1 hx:rtl:mr-1;
|
|
|
|
span:target + &,
|
|
:hover > &,
|
|
&:focus-visible {
|
|
@apply hx:opacity-100;
|
|
}
|
|
|
|
span + &,
|
|
:hover > & {
|
|
@apply hx:no-underline!;
|
|
}
|
|
|
|
@apply hx:after:text-gray-300 hx:dark:after:text-neutral-700;
|
|
&:after {
|
|
@apply hx:content-['#'] hx:px-1;
|
|
span:target + & {
|
|
@apply hx:text-gray-400;
|
|
@apply hx:dark:text-neutral-500;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
article details > summary {
|
|
&::-webkit-details-marker {
|
|
@apply hx:hidden;
|
|
}
|
|
&::before {
|
|
background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='hx:h-5 hx:w-5' viewBox='0 0 20 20' fill='currentColor'%3E%3Cpath fill-rule='evenodd' d='M7.293 14.707a1 1 0 010-1.414L10.586 10 7.293 6.707a1 1 0 011.414-1.414l4 4a1 1 0 010 1.414l-4 4a1 1 0 01-1.414 0z' clip-rule='evenodd' /%3E%3C/svg%3E");
|
|
height: 1.2em;
|
|
width: 1.2em;
|
|
vertical-align: -4px;
|
|
padding: 0 0.6em;
|
|
}
|
|
}
|
|
|
|
:lang(fa) ol {
|
|
list-style-type: persian;
|
|
}
|