ADR-0040: 웹의 화면 글꼴은 문자 범위의 조각으로 나눠, 화면에 나온 글자의 조각만 받는다
누가 무엇을 정했나
메인테이너가 휴대폰의 첫 내려받기를 줄이는 일을 고르고(2026-11-03), Claude가 조각의 나눔과 방법을 정했다. 메인테이너가 승인했다(2026-11-03: “ADR-0040: 승인”).
배경
웹 버전의 첫 방문에 내려받는 것은 gzip으로 465 KB였다. 그 가운데 320 KB(70%)가 화면에 쓰는 블록 글꼴(woff2) 하나다. 이 글꼴에는 ADR-0034대로 한글 음절 11,172자가 모두 들어 있다. 하지만 한 문서에 쓰이는 한글은 수백 자이고, 영어만 쓰는 문서에는 한글이 하나도 없다. 휴대폰(R-NFR-09, QA-18)에서는 이 내려받기가 시작 시간을 늘린다(→ 2026-11-01-04-examples-button-android-load).
텍스트 폭은 글꼴 파일이 아니라 번들한 폭 테이블로 센다(ADR-0026). 그래서 화면 글꼴이 늦게 오거나 나눠 와도 레이아웃은 바뀌지 않고, 그 사이에는 대체 글꼴로 보일 뿐이다.
결정 기준
- 첫 방문에 받는 양이 줄어야 한다. 영어 문서와 한국어 문서 모두
- 저장 파일의 글꼴(서브셋, ADR-0039)과 레이아웃은 바뀌지 않아야 한다
- 다시 빌드해도 같은 조각이 나와야 한다(결정적)
- 조각의 목록이 첫 JS를 크게 늘리지 않아야 한다
검토한 대안
대안 A: 지금대로 한 파일
- 장점: 단순하다. 한 번 받으면 어느 글자든 바로 보인다
- 단점: 영어만 쓰는 사람도 한글 전체(320 KB)를 받는다
대안 B: 문자 범위의 조각으로 나눈다(CSS unicode-range)
같은 글꼴 이름으로 FontFace를 조각마다 하나씩 등록하고, 조각마다 담은 글자를 unicodeRange로 알린다. 브라우저는 화면에 나온 글자가 든 조각만 받는다. Google Fonts가 한국어 글꼴을 내보내는 방법이다.
- 장점: 받는 양이 쓰인 글자에 비례한다
- 단점: 조각마다 요청이 하나씩 생긴다. 조각을 나누는 기준(어떤 글자를 함께 둘지)을 정해야 한다
대안 C: 쓰인 글자만 그때그때 서브셋으로 떠서 쓴다
저장할 때 쓰는 서브세팅(hb-subset wasm)으로 화면 글꼴도 만든다.
- 장점: 꼭 쓰인 글자만 받는다
- 단점: wasm(667 KB)과 TTF(1.34 MB)를 먼저 받아야 해서 첫 방문이 오히려 커진다
결정
대안 B. 조각은 38개다(2026-11-03 빌드).
| 조각 | 담은 글자 | 크기(woff2) |
|---|---|---|
| 0 | 라틴(ASCII · Latin-1), 문장 부호, 화살표 · 수학 기호 · 상자 · 도형 | 23.7 KB |
| 1 | 라틴 확장, 그리스, 키릴 | 16.3 KB |
| 2 | CJK 문장 부호, 가나, 한글 자모, 전각 | 30.6 KB |
| 3 ~ 12 | 자주 쓰는 한글 1,008자, 쓰는 순서대로 100자씩 | 7 ~ 10 KB씩 |
| 13 ~ 37 | 나머지 한글 10,164자, 코드 순서대로 400자씩 | 17 ~ 24 KB씩 |
- 조각 0은 시작할 때 받는다. 다른 조각은 처음부터 등록하지 않고, 조각 0이 온 뒤에 한꺼번에 등록한다. 첫 그림이 한글 조각을 기다리거나 그 사이에 받으러 가지 않게 하려는 것이다
- “자주 쓰는 한글”은 이 저장소의 한국어 문서(
docs·atelier·til·journal)에서 센 순서다(2026-11-03, 384,230자 가운데 1,008종). 다시 빌드해도 같은 조각이 나오도록 그 순서를 파일(src/packages/fonts/scripts/hangul-order.txt)로 고정했다. 이 1,008자가 문서에 쓰인 한글의 100%이고, 앞의 500자가 98%다 - 조각의 목록(
src/packages/fonts/src/generated/screen-slices.ts)은 짧게 적는다. 자주 쓰는 조각은 글자 자체, 나머지 조각은 첫 글자와 끝 글자만 적고, 브라우저가unicode-range를 계산한다. 첫 JS에 gzip 4 KB쯤 더해진다 - 글꼴 빌드 스크립트
build-fonts.py가 조각을 만든다(--slices-only). 한 파일짜리 woff2는 웹이 아닌 호스트를 위해 남긴다
결과
- 좋아지는 점: 첫 방문에 내려받는 것(gzip)이 465 KB에서 176 KB로 준다. 영어 문서는 조각 0(24 KB)만 받는다. 예제 열 개에 쓰인 한글을 모두 보여도 한글 조각은 9개(77 KB)다. 다시 방문할 때 글꼴까지 받는 시간이 3.4초에서 2.1초로 준다(CPU 6배 느림 · slow 4G, 다섯 번의 중앙값, 같은 날 같은 기계에서 고치기 전과 견줌)
- 감수하는 점: 처음 보는 글자의 조각이 올 때까지 그 글자가 잠깐 대체 글꼴로 보인다(레이아웃은 그대로). 조각마다 요청이 하나씩 생긴다. 첫 화면이 뜨는 시간은 거의 그대로다. 그 시간은 내려받기보다 JS 실행과 그리기에 든다
- 후속 작업: 첫 방문의 CPU 시간(JS 실행, 환영 모달의 썸네일 열 개)을 프로파일로 찾아 줄이기 → backlog. 번들 사이즈 체크의 한도를 212 KB(176 KB + 20%)로 낮춤 → 5. 배포