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
2CJK 문장 부호, 가나, 한글 자모, 전각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. 배포