* 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.
141 lines
5.5 KiB
HTML
141 lines
5.5 KiB
HTML
{{- /* Asciinema */ -}}
|
|
|
|
{{- $asciinemaBase := "" -}}
|
|
{{- $useDefaultCdn := true -}}
|
|
{{- with site.Params.asciinema.base -}}
|
|
{{- $asciinemaBase = . -}}
|
|
{{- $useDefaultCdn = false -}}
|
|
{{- end -}}
|
|
|
|
{{- $asciinemaJsAsset := "" -}}
|
|
{{- with site.Params.asciinema.js -}}
|
|
{{- $asciinemaJsAsset = . -}}
|
|
{{- end -}}
|
|
|
|
{{- $asciinemaCssAsset := "" -}}
|
|
{{- with site.Params.asciinema.css -}}
|
|
{{- $asciinemaCssAsset = . -}}
|
|
{{- end -}}
|
|
|
|
{{- /* If only js/css is set without base, use local asset loading */ -}}
|
|
{{- if and $useDefaultCdn (or (ne $asciinemaJsAsset "") (ne $asciinemaCssAsset "")) -}}
|
|
{{- $useDefaultCdn = false -}}
|
|
{{- end -}}
|
|
|
|
{{- /* Set default CDN base if needed */ -}}
|
|
{{- if $useDefaultCdn -}}
|
|
{{- $asciinemaBase = "https://cdn.jsdelivr.net/npm/asciinema-player@latest/dist/bundle" -}}
|
|
{{- end -}}
|
|
|
|
{{- $isRemoteBase := or (strings.HasPrefix $asciinemaBase "http://") (strings.HasPrefix $asciinemaBase "https://") -}}
|
|
{{- $minSuffix := cond hugo.IsProduction ".min" "" -}}
|
|
|
|
{{- /* CSS retrieval: get raw CSS from either local asset or remote, then process */ -}}
|
|
{{- if $isRemoteBase -}}
|
|
{{- $cssPath := cond (ne $asciinemaCssAsset "") $asciinemaCssAsset "asciinema-player.css" -}}
|
|
{{- $asciinemaCssUrl := printf "%s/%s" $asciinemaBase $cssPath -}}
|
|
{{- with try (resources.GetRemote $asciinemaCssUrl) -}}
|
|
{{- with .Err -}}
|
|
{{- errorf "Could not retrieve Asciinema css file from %s. Reason: %s." $asciinemaCssUrl . -}}
|
|
{{- else with .Value -}}
|
|
{{- with resources.Copy "css/asciinema-player.css" . -}}
|
|
{{- $asciinemaCss := . | fingerprint -}}
|
|
<link rel="stylesheet" href="{{ $asciinemaCss.RelPermalink }}" integrity="{{ $asciinemaCss.Data.Integrity }}" crossorigin="anonymous" />
|
|
{{- end -}}
|
|
{{- end -}}
|
|
{{- end -}}
|
|
{{- else if $asciinemaCssAsset -}}
|
|
{{- with resources.Get $asciinemaCssAsset -}}
|
|
{{- $asciinemaCss := . | fingerprint -}}
|
|
<link rel="stylesheet" href="{{ $asciinemaCss.RelPermalink }}" integrity="{{ $asciinemaCss.Data.Integrity }}" crossorigin="anonymous" />
|
|
{{- else -}}
|
|
{{- errorf "Asciinema css asset not found at %q" $asciinemaCssAsset -}}
|
|
{{- end -}}
|
|
{{- end -}}
|
|
|
|
{{- /* JS retrieval: get raw JS from either local asset or remote, then process */ -}}
|
|
{{- if $isRemoteBase -}}
|
|
{{- $jsPath := cond (ne $asciinemaJsAsset "") $asciinemaJsAsset (printf "asciinema-player%s.js" $minSuffix) -}}
|
|
{{- $asciinemaJsUrl := printf "%s/%s" $asciinemaBase $jsPath -}}
|
|
{{- with try (resources.GetRemote $asciinemaJsUrl) -}}
|
|
{{- with .Err -}}
|
|
{{- errorf "Could not retrieve Asciinema js file from %s. Reason: %s." $asciinemaJsUrl . -}}
|
|
{{- else with .Value -}}
|
|
{{- with resources.Copy (printf "js/asciinema-player%s.js" $minSuffix) . -}}
|
|
{{- $asciinemaJs := . | fingerprint -}}
|
|
<script defer src="{{ $asciinemaJs.RelPermalink }}" integrity="{{ $asciinemaJs.Data.Integrity }}" crossorigin="anonymous"></script>
|
|
{{- end -}}
|
|
{{- end -}}
|
|
{{- end -}}
|
|
{{- else if $asciinemaJsAsset -}}
|
|
{{- with resources.Get $asciinemaJsAsset -}}
|
|
{{- $asciinemaJs := . | fingerprint -}}
|
|
<script defer src="{{ $asciinemaJs.RelPermalink }}" integrity="{{ $asciinemaJs.Data.Integrity }}" crossorigin="anonymous"></script>
|
|
{{- else -}}
|
|
{{- errorf "Asciinema js asset not found at %q" $asciinemaJsAsset -}}
|
|
{{- end -}}
|
|
{{- end -}}
|
|
|
|
<script data-playback-time="{{ (T "playbackTime") | default "Playback time" }}">
|
|
const playbackTimeLabel =
|
|
document.currentScript?.getAttribute("data-playback-time") || "Playback time";
|
|
|
|
document.addEventListener("DOMContentLoaded", () => {
|
|
const observers = [];
|
|
|
|
const applyTimerA11y = (container) => {
|
|
container.querySelectorAll(".ap-timer[role='textbox']").forEach((timer) => {
|
|
if (!timer.getAttribute("aria-label")) {
|
|
timer.setAttribute("aria-label", playbackTimeLabel);
|
|
}
|
|
});
|
|
};
|
|
|
|
// Fix play button position issue
|
|
const style = document.createElement("style");
|
|
style.textContent = `
|
|
.ap-player .ap-overlay-start .ap-play-button span > svg {
|
|
display: inline;
|
|
}
|
|
`;
|
|
document.head.appendChild(style);
|
|
// Initialize asciinema players
|
|
document.querySelectorAll(".asciinema-player").forEach((el) => {
|
|
const castFile = el.dataset.castFile;
|
|
const theme = el.dataset.theme || "asciinema";
|
|
const speed = parseFloat(el.dataset.speed) || 1;
|
|
const autoplay = el.dataset.autoplay === "true";
|
|
const loop = el.dataset.loop === "true";
|
|
const poster = el.dataset.poster || "";
|
|
const markers = el.dataset.markers ? JSON.parse(el.dataset.markers) : [];
|
|
|
|
// Create asciinema player
|
|
if (window.AsciinemaPlayer) {
|
|
window.AsciinemaPlayer.create(castFile, el, {
|
|
theme: theme,
|
|
speed: speed,
|
|
autoplay: autoplay,
|
|
loop: loop,
|
|
poster: poster || undefined,
|
|
markers: markers.length > 0 ? markers : undefined,
|
|
controls: true, // Always show user controls (bottom control bar)
|
|
idleTimeLimit: 2, // Limit terminal inactivity to 2 seconds (compress pauses longer than 2s)
|
|
});
|
|
applyTimerA11y(el);
|
|
const observer = new MutationObserver(() => applyTimerA11y(el));
|
|
observer.observe(el, { childList: true, subtree: true });
|
|
observers.push(observer);
|
|
}
|
|
});
|
|
|
|
// Prevent lingering observers when navigating away.
|
|
window.addEventListener(
|
|
"pagehide",
|
|
() => {
|
|
observers.forEach((observer) => observer.disconnect());
|
|
},
|
|
{ once: true },
|
|
);
|
|
});
|
|
</script>
|