9148c358d0
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
4.8 KiB
4.8 KiB
id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack
| id | title | category | status | canonical_id | aliases | duplicate_of | source_trust_level | confidence_score | verification_status | tags | raw_sources | last_reinforced | github_commit | tech_stack | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| wiki-2026-0508-web-content-accessibility-guidel | Web Content Accessibility Guidelines (WCAG) | 10_Wiki/Topics | verified | self |
|
none | A | 0.9 | applied |
|
2026-05-10 | pending |
|
Web Content Accessibility Guidelines (WCAG)
매 한 줄
"매 W3C WAI 의 매 web 접근성 국제 표준". 매 4 원칙 (POUR — Perceivable, Operable, Understandable, Robust) 아래 매 testable success criteria 를 매 A / AA / AAA 3 단계로 분류한다. 매 2026 기준 WCAG 2.2 가 매 사실상 표준, WCAG 3.0 (Silver) 은 W3C Working Draft 단계로 매 점수 기반 모델 도입 진행 중.
매 핵심
매 4 원칙 (POUR)
- Perceivable — 매 정보 / UI 의 매 인지 가능 (text alt, contrast, captions).
- Operable — 매 keyboard / time / seizure / navigation 가능.
- Understandable — 매 readable / predictable / input assistance.
- Robust — 매 보조 기술 호환 (parsing, name/role/value).
매 적합 수준
- A — 매 minimum, 매 미준수 시 일부 사용자 완전 차단.
- AA — 매 industry standard, 매 EU EAA / US Section 508 / 한국 KWCAG 의 매 baseline.
- AAA — 매 enhanced, 매 모든 콘텐츠에 일률 적용 권장 X.
매 WCAG 2.2 의 매 새 success criteria (2023.10 W3C Rec)
- 2.4.11 Focus Not Obscured (Minimum) — AA.
- 2.5.7 Dragging Movements — AA.
- 2.5.8 Target Size (Minimum 24×24 CSS px) — AA.
- 3.2.6 Consistent Help — A.
- 3.3.7 Redundant Entry — A.
- 3.3.8 Accessible Authentication (Minimum) — AA.
매 응용
- 매 정부 / 공공 사이트 의무 준수 (KWCAG 2.2 — Korea).
- 매 EU Accessibility Act (2025.06 발효) — 매 commercial 도 의무.
- 매 lawsuit 위험 회피 (US ADA Title III).
💻 패턴
Semantic HTML 우선
<!-- Bad -->
<div onclick="submit()" class="btn">Save</div>
<!-- Good -->
<button type="submit">Save</button>
명도 대비 (1.4.3 Contrast Minimum)
/* normal text ≥ 4.5:1, large text ≥ 3:1 */
:root {
--fg: #1a1a1a; /* on white = 16.1:1 */
--link: #0050d8; /* on white = 7.2:1 */
}
Focus indicator (2.4.11 + 2.4.13)
:focus-visible {
outline: 2px solid #0050d8;
outline-offset: 2px;
}
button:focus-visible { box-shadow: 0 0 0 3px rgba(0,80,216,.4); }
Target size 24×24 (2.5.8)
button.icon {
min-width: 24px;
min-height: 24px;
padding: 8px;
}
Form label (3.3.2 Labels or Instructions)
<label for="email">Email</label>
<input id="email" type="email" required aria-describedby="email-help" />
<small id="email-help">we never share it</small>
Live region for async update (4.1.3)
<div role="status" aria-live="polite" id="msg"></div>
<script>
document.getElementById('msg').textContent = '저장 완료';
</script>
Skip link (2.4.1 Bypass Blocks)
<a class="skip" href="#main">Skip to main content</a>
<main id="main" tabindex="-1">...</main>
<style>
.skip { position:absolute; left:-999px; }
.skip:focus { left:1rem; top:1rem; }
</style>
Auto check in CI
# .github/workflows/a11y.yml
- run: npx @axe-core/cli http://localhost:3000 --tags wcag2aa,wcag22aa
- run: npx pa11y-ci
매 결정 기준
| 상황 | 적합 수준 |
|---|---|
| 공공 / 정부 (KR/EU/US) | AA (의무) |
| Commercial B2C | AA (lawsuit 회피) |
| 의료 / 교육 | AA + 일부 AAA |
| Internal tool | A 최소 |
기본값: WCAG 2.2 AA 를 매 baseline 으로, 매 axe-core / Lighthouse / pa11y CI 자동화.
🔗 Graph
- 부모: Accessibility (A11y) · Web Standards
- 응용: ARIA · Semantic HTML · Screen Reader
- Adjacent: Lighthouse
🤖 LLM 활용
언제: 매 success criterion 매핑, 매 ARIA 패턴 보일러플레이트. 언제 X: 매 진짜 사용자 검증 — 매 screen reader / 매 disabled user testing 의 대체 불가.
❌ 안티패턴
- Div soup: 매 button / link / heading 의 매
<div>대체. - Color-only signal: 매 색만으로 매 error 표시 (1.4.1 위반).
- Auto-play audio: 매 1.4.2 위반.
- Click-only: 매 keyboard handler 누락.
- Empty alt 잘못: 매 의미 있는 이미지에 매
alt="". role="button"on div: 매 button 으로 매 semantic 맞추는 게 매 정답.
🧪 검증 / 중복
- Verified (W3C WCAG 2.2 Recommendation 2023.10, EU EAA 2025.06).
- 신뢰도 A.
🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — WCAG 2.2 새 SC 6 종 + EU EAA 2025 반영 |