~/posts/web/subset-korean-webfont.md

date:
tags: [web-font, astro, performance, self-hosting]
from: 오늘의앙리
read: 6분

한글 웹폰트, 쓰는 글자만 남기기

안녕하세요, 개발자 브론입니다. 이번 글에서는 팀 랜딩 페이지를 만들며 웹폰트를 어떻게 다뤘는지 정리하려고 합니다.

랜딩 페이지에는 따로 부르는 API가 없어서 정적 페이지로 만들었습니다. 그러니 느리다면 원인은 브라우저가 받아 오는 파일 쪽에 있을 가능성이 높습니다.

소개 페이지라 화면의 대부분은 글자입니다. 그래서 폰트를 오래 골랐고, IBM Plex Sans KR과 Gowun Batang으로 정했습니다. 둘 다 OFL 라이선스라 상업적으로 써도 되는지도 확인했고요.

간단하게 만든 뒤 Lighthouse를 돌려 봤습니다. 그런데 웬걸, 모바일 성능이 66점 나왔습니다. 범인은 폰트였습니다. 두 폰트를 그대로 올리니 CSS만 380KB였거든요.

왜 직접 호스팅했나

전에는 Google Fonts를 즐겨 썼습니다. 링크 한 줄이면 끝나니까요. 이번에도 그렇게 하려는데, 같이 작업하던 AI가 물었습니다. “개인정보 처리방침은 있나요?”

Google Fonts에서 폰트를 받으면 방문자 브라우저가 Google 서버에 직접 요청합니다. 그 요청에는 방문자 IP가 실립니다. 저는 몰랐는데, 이렇게 IP가 바깥 서비스로 넘어가면 처리방침에 적어야 할 수 있다고 하더라고요.

랜딩 페이지 첫 버전은 처리방침 없이 내기로 했습니다. 그래서 폰트를 Fontsource로 받아 사이트에서 직접 내려주기로 했습니다. 두 폰트 모두 SIL OFL 1.1이라 직접 호스팅해도 됩니다.

처리방침이 생기면 그때 Google Fonts를 다시 볼 생각입니다.

무엇이 무거웠나

Fontsource는 한글처럼 글자가 많은 폰트를 조각으로 나눠 둡니다. IBM Plex Sans KR은 font-weight 하나마다 94조각이 있습니다. 조각마다 @font-face가 하나씩 있고, 거기에 unicode-range로 “이 조각에는 이 글자들이 들어 있다”고 적혀 있습니다.

@fontsource/ibm-plex-sans-kr/400.css (94개 중 1개)
@font-face {
font-family: 'IBM Plex Sans KR';
font-weight: 400;
src: url(./files/ibm-plex-sans-kr-0-400-normal.woff2) format('woff2'),
url(./files/ibm-plex-sans-kr-0-400-normal.woff) format('woff');
unicode-range: U+f9ca-fa0b, U+ff03-ff05, /* … */;
}

브라우저는 화면에 나온 글자가 든 조각만 받습니다. 폰트 파일은 똑똑하게 나눠 받는 셈입니다. 문제는 CSS입니다. 쓰든 안 쓰든 조각 전부의 @font-face가 CSS에 들어갑니다.

저는 IBM Plex Sans KR을 400·500·600·700, Gowun Batang을 700으로 썼습니다. 그랬더니 이렇게 됐습니다.

  • 폰트 CSS 380KB (gzip 158KB), @font-face 471개
  • 이 CSS가 렌더링을 막고, Lighthouse는 “사용하지 않는 CSS 152KiB”라고 경고
  • 첫 화면에서 폰트 조각 36개, 529KiB를 받음

정작 화면에 쓰인 글자는 몇백 자뿐인데, 그 글자를 그리려고 이만큼을 받고 있었습니다. 이걸 어떻게 줄일지 한참 고민했습니다.

쓰는 글자만 남기기

랜딩 페이지는 문구가 거의 바뀌지 않습니다. 쓰는 글자가 정해져 있다면, 그 글자만 담은 폰트를 미리 만들어 두면 됩니다. 이렇게 필요한 글자만 남기는 걸 서브셋이라고 합니다.

스크립트 하나(scripts/subset-fonts.mjs)가 이 일을 합니다.

  1. src 안의 .astro·.md·.ts 같은 파일에서 글자를 모두 모읍니다
  2. 영문·숫자(ASCII)와 자주 쓰는 문장부호는 늘 넣습니다
  3. 원본 TTF를 받아 모은 글자만 남긴 woff2를 만듭니다
  4. 만든 폰트와 모은 글자 목록(chars.json)을 저장소에 커밋합니다
scripts/subset-fonts.mjs (줄임)
async function collectChars() {
// src 안 텍스트 파일의 모든 글자. 주석·코드 글자까지 들어간다
const files = (await walk('src')).filter((f) => /\.(astro|md|mdx|ts|js|mjs)$/.test(f));
const sources = await Promise.all(files.map((f) => readFile(f, 'utf8')));
return toSet(BASE_CHARS + sources.join(''));
}

주석과 코드의 글자까지 다 모읍니다. 화면에 나오는 글자만 정확히 골라내려면 HTML을 렌더링해서 텍스트를 뽑아야 하는데, 그보다 조금 넉넉하게 모으는 쪽이 훨씬 단순했습니다.

원본은 google/fonts 저장소의 TTF를 커밋까지 고정해서 받습니다. 언제 다시 돌려도 같은 폰트가 나오게 하려고요.

scripts/subset-fonts.mjs
// google/fonts 커밋을 고정해 같은 결과가 나오게 한다
const GOOGLE_FONTS_REV = '47d54ca1ebb14fd864695f1d39dc734f39017c33';

서브셋은 subset-font로 만들었습니다. HarfBuzz를 WebAssembly로 감싼 라이브러리라 Python fontTools를 따로 깔지 않아도 Node 안에서 끝납니다. 스크립트를 돌릴 때만 쓰고, 사이트에는 들어가지 않습니다.

CSS는 @font-face 471개에서 5개가 됐습니다. font-weight마다 하나씩입니다.

src/styles/fonts.css (5개 중 1개)
@font-face {
font-family: 'IBM Plex Sans KR';
font-weight: 400;
font-display: swap;
src: url('../assets/fonts/ibm-plex-sans-kr-400.woff2') format('woff2');
}

빠진 글자는 빌드에서 막기

서브셋에는 약점이 하나 있습니다. 문구를 고치다 새 글자가 생기면, 그 글자는 서브셋에 없습니다. 브라우저는 그 글자만 시스템 폰트로 그립니다. 한 문장 안에서 한 글자만 모양이 다른, 눈치채기 어려운 버그가 됩니다.

그래서 빌드 전에 검사합니다. prebuild에 걸어 두면 npm run build 때마다 먼저 돕니다.

package.json (일부)
"fonts": "node scripts/subset-fonts.mjs",
"fonts:check": "node scripts/subset-fonts.mjs --check",
"prebuild": "npm run fonts:check --silent"

검사는 단순합니다. 지금 문구에서 글자를 다시 모으고, 커밋해 둔 chars.json과 비교합니다. 없는 글자가 하나라도 있으면 빌드를 멈춥니다.

scripts/subset-fonts.mjs (줄임)
const missing = [...want].filter((c) => !have.includes(c));
if (missing.length) {
console.error(`[fonts] 서브셋에 없는 글자 ${missing.length}개: ${missing.join('')}`);
console.error('[fonts] `npm run fonts`로 서브셋을 다시 만들고 src/assets/fonts를 커밋하세요.');
process.exit(1);
}

실제로 공유 이미지의 대체 텍스트(alt)를 바꿨을 때 “과”와 “림” 두 글자 때문에 서브셋을 다시 만들었습니다.

비용도 있습니다. 문구를 바꾸는 PR이 동시에 두 개 열리면, 둘 다 폰트 파일을 다시 만들어서 서로 충돌합니다. 그때는 먼저 머지된 쪽 위로 올리고 npm run fonts를 한 번 더 돌렸습니다.

결과

비교는 같은 조건에서 다시 쟀습니다. 로컬 astro preview, Lighthouse 12, 세 번 잰 값입니다. 처음 본 66점은 다른 환경에서 잰 점수라 표에 넣지 않았습니다.

수정 전 수정 후
폰트 CSS 380KB (gzip 158KB) 14KB (gzip 6.4KB)
폰트 전송 36개, 529KiB 5개, 167KiB
성능 점수 95 98
FCP / LCP 2.3s / 2.4s 1.8s / 2.0s
페이지 총량 741KiB 226KiB
빌드 결과(dist/) 14MB 836KB

글꼴이 바뀌지 않았는지도 확인했습니다. 1280px·390px 전체 화면을 수정 전후로 찍어 픽셀을 비교했고, 다른 곳은 없었습니다.

CSS를 HTML 안에 넣는 방법(inlineStylesheets: 'always')도 시험해 봤습니다. FCP가 0.1초쯤 줄었을 뿐이라 넣지 않았습니다.

이 블로그에서는 쓰지 않은 이유

지금 보고 계신 이 블로그도 IBM Plex Sans KR을 씁니다. 그런데 여기서는 서브셋을 만들지 않고 Fontsource 조각을 그대로 씁니다.

랜딩 페이지는 문구가 거의 바뀌지 않습니다. 쓰는 글자가 닫혀 있으니 서브셋이 잘 맞습니다. 블로그는 글을 쓸 때마다 새 글자가 나옵니다. 글마다 서브셋을 다시 만들고 커밋하는 건 배보다 배꼽이 큽니다. 조각 방식은 처음 보는 글자가 나와도 그 조각만 받으면 됩니다.

배운 것

서브셋은 문구가 거의 바뀌지 않는 정적 페이지에서 이득입니다. 문구가 자주 바뀌는 곳이라면 바꿀 때마다 폰트를 다시 만들어야 하고, 빠진 글자를 막는 검사까지 따로 둬야 합니다. 그만큼 손이 많이 갑니다.

외부 폰트 서비스를 쓰면 방문자 IP가 그 서비스로 간다는 것도 이번에 처음 알았습니다. 처리방침을 갖춘 사이트라면 Google Fonts가 더 간단할 수 있습니다. 다만 한글은 Google Fonts도 같은 조각 방식이라, 이 페이지에서도 폰트 조각을 36개 받았습니다.

esc

// 최근 글