Timmy_Foundation/timmy-config
15
0
Fork 0
Code Issues 163 Pull Requests 104 Actions Packages Projects Releases Wiki Activity

feat(a11y): add skip navigation link for WCAG 2.4.1 compliance
Some checks failed
Architecture Lint / Linter Tests (pull_request) Successful in 26s
Details
PR Checklist / pr-checklist (pull_request) Failing after 2m28s
Details
Smoke Test / smoke (pull_request) Failing after 33s
Details
Validate Config / YAML Lint (pull_request) Failing after 14s
Details
Validate Config / JSON Validate (pull_request) Successful in 14s
Details
Validate Config / Python Syntax & Import Check (pull_request) Failing after 43s
Details
Validate Config / Python Test Suite (pull_request) Has been skipped
Details
Validate Config / Shell Script Lint (pull_request) Failing after 36s
Details
Validate Config / Cron Syntax Check (pull_request) Successful in 7s
Details
Validate Config / Deploy Script Dry Run (pull_request) Successful in 11s
Details
Validate Config / Playbook Schema Validation (pull_request) Successful in 30s
Details
Architecture Lint / Lint Repository (pull_request) Failing after 28s
Details

Browse Source 
Add R5 skip navigation link template and supporting CSS to meet WCAG 2.4.1 Bypass Blocks (A).

- New template: deploy/gitea-a11y/custom/templates/custom/skip_link.tmpl
  Provides a "Skip to main content" anchor as the first focusable element.
- Updated deploy/gitea-a11y/custom/public/css/a11y-fixes.css (V5):
  Styles for .skip-link, visually hidden off-screen until focus.
- Updated README.md with R5 documentation and activation instructions.
- deploy-gitea-a11y.sh: include R5 in deployed fixes list.

Usage: Insert `{{template "custom/skip_link" .}}` immediately after <body> in custom/header.tmpl.

Targets #545. Part of STEP35 FREE BURN — Gitea-first a11y V1.
This commit is contained in:
Rockachopa
2026-04-30 19:44:29 -04:00
parent ba4220d5ed
commit c28d462c4a
4 changed files with 76 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
deploy/gitea-a11y/README.md
View File

@@ -10,6 +10,7 @@ Applied fixes identified by the accessibility audit (#492):
| R2 | #552 | 3.3.1 | `aria-required="true"` on required form fields |
| R3 | #553 | 4.1.2 | `aria-label` on star/fork count links ("2 stars", "0 forks") |
| R4 | #554 | 1.3.1 | `<time datetime="...">` elements for relative timestamps |
| R5 | #545 | 2.4.1 | Skip navigation link for keyboard users |
## Structure
@@ -20,14 +21,18 @@ deploy/gitea-a11y/
└── custom/
├── public/
│ ├── css/
│ │ └── a11y-fixes.css # Global CSS fixes (R4, R5)
│ └── js/
└── templates/
├── custom/
│ └── time_relative.tmpl # R4: <time> helper
├── repo/
│ └── list_a11y.tmpl # R3: aria-label on counts
└── user/auth/
└── signin_inner.tmpl # R1+R2: password toggle + aria-required
│ ├── a11y_head.tmpl # R4: Inject CSS into <head>
│ ├── header_banner.tmpl # Bypass: <header role="banner">
│ ├── skip_link.tmpl # R5: Skip navigation link (WCAG 2.4.1)
│ └── time_relative.tmpl # R4: <time> helper
├── user/auth/
│ └── signin_inner.tmpl # R1+R2: password toggle + aria-required
└── repo/
└── list_a11y.tmpl # R3: aria-label on star/fork counts
```
## Deploy
@@ -60,5 +65,24 @@ readers announce the meaning, not just the number.
### R4: `<time>` Elements
Wraps relative timestamps ("2 minutes ago") in `<time datetime="2026-04-13T17:00:00Z">`
Wraps relative timestamps ("2 minutes ago") in `<time datetime="...">`
providing both human-readable text and machine-readable ISO 8601 dates.
### R5: Skip Navigation Link (WCAG 2.4.1)
Adds a "Skip to main content" link as the first focusable element.
Keyboard users can press Tab at the top of a page to jump directly
to the main content area, bypassing repeated navigation menus.
**Template:** `custom/skip_link.tmpl`
**Insert:** At the very start of `<body>` in your custom `header.tmpl`:
```handlebars
{{template "custom/skip_link" .}}
```
Gitea's default page layout uses `<main id="main">` as the content target.
If your instance uses `#content`, adjust the `href` in the template.
The CSS in `a11y-fixes.css` visually hides the link off-screen until it
receives keyboard focus, meeting WCAG 2.4.1 Bypass Blocks (A).