Skip to content

[DONE] 저널의 다른 언어 링크와 Archive 글자가 바탕에서 또렷하게 읽힌다 - #308

Merged
patternflow-bot merged 4 commits into
devfrom
claude/dev-pf-round135-9nwvb6
Oct 27, 2026
Merged

patternflow-bot merged 4 commits into
devfrom
claude/dev-pf-round135-9nwvb6

Conversation

@patternflow-bot

@patternflow-bot patternflow-bot commented Oct 27, 2026 •

Copy link
Copy Markdown

dev / https://claude.ai/code/session_01Gdqi6R6834tsaKqp5Fe9WK

저널의 언어 전환에서 지금 쪽이 아닌 언어(KO, EN)와 목록의 「Archive」 가 흐린 회색이라, 글 쪽 크림 바탕에서 2.3:1, 목록의 흰 판에서 2.6:1 이었어요. axe 가 저널 76쪽 모두에서 잡았어요. 머지하면 둘이 저널 날짜와 같은 글자색(#6B655A)이 되어 5.0:1, 5.8:1 로 읽히고, 지금 언어는 그대로 더 짙어요.

좋아지는 것: 저널의 다른 언어 링크와 Archive 가 또렷하다 — 영어판으로 가는 길이 눈에 띈다

체크리스트

한 일

  • web/src/app/globals.css 의 .journal-lang-switch 와 .journal-archive-label 글자색을 --ink-faint(#A69F90)에서 --ink-muted(#6B655A)로 바꿨어요. 토큰은 그대로예요. .journal-lang-switch a.active 의 --ink 와 hover 도 그대로예요.
  • web/src/components/journal/journalCss.test.ts 에 시험 셋을 더했어요. globals.css 의 :root 토큰을 풀어 WCAG 대비를 셈해요. 다른 언어가 크림과 흰 판에서 4.5:1 넘는지, 지금 언어와 3:1 넘게 떨어지는지, 「Archive」 가 흰 판에서 4.5:1 넘는지예요.

증거

dev 빌드와 이 브랜치 빌드를 next start 로 띄우고, /journal, /journal/en 과 거기서 잇는 글 74쪽을 390px 와 1440px 로 열어 axe-core 4.10.3 의 color-contrast 를 돌렸어요.

dev 이 브랜치
쪽 × 폭 152 152
--ink-faint 글자의 실패 156곳(152 모두에서) 0
그 밖의 실패(.pf-ghost 번호, LED 주황 날짜) 740곳 740곳, 같은 자리 같은 값
다른 언어 · 글 쪽 크림 2.30:1 5.04:1
다른 언어 · 목록 흰 판 2.63:1 5.78:1
「Archive」 · 목록 흰 판 2.63:1 5.78:1
지금 언어와 다른 언어 사이 7.00:1 3.19:1

dev 의 156곳은 글 쪽마다 ko 와 en 둘(148곳), 목록 두 쪽의 언어 둘(4곳)과 「Archive」(4곳)예요.

새 시험을 dev 의 globals.css 에 돌리면

× journal faint text > shows the other language at 4.5:1 on the cream and on the panel
  → expected 2.296754348235592 to be greater than or equal to 4.5
✓ journal faint text > keeps the current language 3:1 apart from the other
× journal faint text > shows the Archive label at 4.5:1 on the panel
  → expected 2.6304659968181876 to be greater than or equal to 4.5
Tests  2 failed | 3 passed (5)

고친 뒤엔 Tests 5 passed (5) 예요.

다섯 검사(web/ 에서):

npm ci                              → exit 0
npm run lint -- --max-warnings=0    → exit 0
npm run typecheck                   → exit 0 (tsc 둘 다)
npm run build                       → exit 0 (dev 판도, 이 브랜치 판도 처음 한 번에)
npm run check:ci                    → exit 0 · Test Files 130 passed (130) · Tests 1597 passed (1597)
                                      drift 14 passed, links-absolute · roadmap skipped (태그 없음 · gh 로그인 없음)
npm run check:voice                 → check:voice: nothing found
npm run check:voice -- -            → (PR 본문) check:voice: nothing found
npm run check:human-lock            → no locked words changed

PR 의 검사(head 4d8a775): Drift checks | completed | success, Web CI | completed | success. 겹침 기다리기는 「안 겹친다」 였어요.

전후 사진은 /journal 첫 화면과 「머리아파」 글 쪽 머리예요. 위가 dev, 아래가 이 브랜치예요. 바뀐 건 「EN」 과 「ARCHIVE」 의 색뿐이에요.

폰 390 · 저널 목록 · dev
폰 390 · 저널 목록 · 이 브랜치
데스크톱 1440 · 글 쪽 · dev
데스크톱 1440 · 글 쪽 · 이 브랜치
데스크톱 1440 · 저널 목록 · dev
데스크톱 1440 · 저널 목록 · 이 브랜치
폰 390 · 글 쪽 · dev
폰 390 · 글 쪽 · 이 브랜치

실행법

cd web
npx vitest run src/components/journal/journalCss.test.ts
npm run build && npx next start -p 3100
# /journal 의 「EN」 과 「ARCHIVE」, /journal/headache 오른쪽 위의 「EN」 을 본다

가정

  • 작업 글이 저널 정리 10바퀴에 연 「흐린 글자 대비의 저널 몫」을 골랐어요. 133 · 134바퀴가 「다음 바퀴」 1번으로 둔 감이기도 해요. --ink-faint 와 --pf-ink-faint 토큰은 compliance 와 editions 도 읽어서 그대로 두고, 저널 규칙 두 곳만 이미 있는 --ink-muted 로 바꿨어요. 목록의 날짜와 쪽 아래 줄이 이미 그 색이에요.
  • 저널이 --ink-faint 를 읽는 나머지 넷은 고치지 않았어요. 목록 머리의 날짜와 읽는 시간 사이 「·」(.journal-featured-meta span + span::before), 쪽 아래 「Patternflow · 2026」 의 「·」(aria-hidden), 글 끝 표시의 가는 줄 둘(.journal-end-mark 의 background)은 글자가 아니라 꾸밈이에요. .journal-list-number 는 그리는 컴포넌트가 없어요(「다음 바퀴」 3).
  • 지금 언어와 다른 언어의 차이가 7.0:1 에서 3.2:1 로 줄어요. 둘은 색으로만 갈라서, 색만으로 가르는 글자 사이를 WCAG 기법 G183 이 잡는 3:1 을 시험의 선으로 뒀어요. 지금 언어엔 aria-current="page" 도 있어요.
  • 남은 대비 실패 740곳은 그대로예요. 큰 회색 번호 .pf-ghost(#C9C2B0, 1.55~1.77:1)는 여러 화면이 같이 쓰는 꾸밈 숫자이고, 강조 글 줄의 LED 주황 날짜(#E8552E, 흰 판에서 3.63:1)는 「창작자가 열어야 하는 것」의 LED 글자색 줄 몫이에요. 있는 색에 더 짙은 주황이 없어요.
  • 표 밖: 없음.

Changelog

Web

  • The journal's language switch and Archive label are readable. The language a page is not in and the index's "Archive" label were #A69F90, 2.3:1 on the cream and 2.6:1 on the white panel, and axe flagged them on all 76 journal pages. They now use the journal's muted ink, 5.0:1 and 5.8:1.

경험

언제: 빌드한 사이트를 next start 로 띄웠다가 끄고 다시 빌드할 때
교훈: pkill -f 'next start' 나 kill $(pgrep -f next-server) 를 쓰지 말고 ps -eo pid,args | awk '$2=="next-server" {print $1}' 로 pid 를 골라 꺼요. 찾는 글이 그 Bash 명령 줄에도 들어 있어서 셸이 저를 죽여요
근거: #308 에서 두 번 그렇게 Bash 가 아무 출력 없이 exit 144 로 끝났고, 그 뒤 빌드도 검사도 돌지 않았어요

바퀴

바퀴 135 · 후보: 저널 — 고친 곳: web/src/app/globals.css(.journal-lang-switch, .journal-archive-label) · 까닭: 저널 76쪽 모두에서 다른 언어 링크와 「Archive」 가 바탕과 2.3~2.6:1 이었다

다음 바퀴

  • 글 쪽에 <main> 이 없다: ArticleLayout.tsx:49 가 <article>, :90 이 <footer> 를 바로 그려요. 오늘 이 브랜치 빌드에서도 axe 가 /journal/headache 와 /journal/headache/en 의 두 폭 모두에서 landmark-one-main 하나와 region 넷을 잡았어요. 목록 쪽은 <main className="journal-index"> 라 0이에요.
  • 글 쪽 OG 그림의 날짜: app/journal/[slug]/opengraph-image.tsx:54 가 post?.date 를 그대로 찍어서 공유 카드에 2026-05-14T01:30:00+09:00 이 나와요. 134바퀴가 서울로 맞춘 formatJournalDate 를 읽으면 돼요.
  • 안 쓰는 규칙 .journal-list-number: globals.css:1144 의 mono 묶음과 :1321 의 색 규칙이 있는데, web/src 어디서도 이 클래스를 그리지 않아요. 목록의 번호는 .pf-ghost 예요.

https://claude.ai/code/session_01Gdqi6R6834tsaKqp5Fe9WK


Generated by Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Gdqi6R6834tsaKqp5Fe9WK
Both were --ink-faint, 2.3:1 on the cream and 2.6:1 on the index's panel.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Gdqi6R6834tsaKqp5Fe9WK
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Gdqi6R6834tsaKqp5Fe9WK
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Gdqi6R6834tsaKqp5Fe9WK
@patternflow-bot patternflow-bot changed the title [WIP] 저널 한 곳을 다듬는다 (135바퀴) [WIP] 저널의 다른 언어 링크와 Archive 글자가 바탕에서 또렷하게 읽힌다 Oct 27, 2026
@patternflow-bot patternflow-bot changed the title [WIP] 저널의 다른 언어 링크와 Archive 글자가 바탕에서 또렷하게 읽힌다 [DONE] 저널의 다른 언어 링크와 Archive 글자가 바탕에서 또렷하게 읽힌다 Oct 27, 2026
@patternflow-bot
patternflow-bot marked this pull request as ready for review October 27, 2026 15:22
@patternflow-bot
patternflow-bot merged commit 281e432 into dev Oct 27, 2026
2 checks passed
@patternflow-bot
patternflow-bot deleted the claude/dev-pf-round135-9nwvb6 branch October 27, 2026 15:24
engmung pushed a commit to engmung/Patternflow that referenced this pull request Oct 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants