ADR-0039: 저장 파일의 서브셋 글꼴은 WOFF로 넣고, 압축은 판을 고정한 JS zlib 라이브러리로 한다
이후 변경
- 2026-11-03: 웹 셸도 같은
fflate로 브라우저 문서를 모두 내보내는 zip과 가져오는 zip을 만들고 푼다. zip은 저장 파일의 바이트에 들지 않는다. 한 모듈이라 첫 방문에 내려받는 JS에 zip 코드도 들어간다 → 1.3 브라우저 문서, 5. 배포- 2026-11-03: 같은
fflate설정(수준 9 · 메모리 수준 8)으로 PDF의 스트림도 압축한다. 텍스트를 모두 외곽선으로 적은 파일에는 서브셋 글꼴을 넣지 않는다 → ADR-0045- 2026-11-01: 압축 라이브러리는
fflate0.8.3(압축 수준 9 · 메모리 수준 8)으로, 서브세팅은harfbuzzjs1.6.3으로 정확한 버전을 고정했다. 버전이나 설정이 바뀌어 바이트가 달라지면 테스트가 알린다 → 9.1 제품에 들어가는 것
배경
저장되는 .ns.svg에는 그림에 쓰인 글자만 남긴 서브셋 글꼴을 data URI로 넣는다(ADR-0026, R-FMT-07). 그 글꼴의 형식이 정해지지 않았다. 파일 형식에 남으므로 공개한 뒤에는 바꾸기 어렵다(바꾸면 형식의 판을 올려야 한다 → 5. 버전 관리).
서브세팅 도구(hb-subset)가 내놓는 것은 압축하지 않은 TTF다. 압축하려면 무엇을 더 실어야 한다.
결정 기준
- 저장 파일이 작다. 노트에 그림을 여러 장 넣으면 쌓인다
- 편집기가 더 싣는 코드가 작다. 웹 버전은 처음 열 때 받는 크기가 중요하다
- “같은 모델이면 같은 파일”(R-FMT-03)을 모든 배포 대상에서 지킨다
- 그림을 보는 쪽(브라우저, GitHub, Obsidian)이 읽는다
검토한 대안
D2Coding 보통 굵기로 잰 서브셋의 크기(커닝 · 합자 · 힌팅 없음, base64 전). 견준 그림은 시안 M45(https://claude.ai/artifact/F5tWhj2q6X6uSGGjrAezRE, 사본 journal/assets/2026-11-01-subset-font-format-study.html)에 있다.
| 문서에 쓰인 글자 | TTF | WOFF | woff2 |
|---|---|---|---|
| 영어만 (ASCII 95자) | 9.4 KB | 6.7 KB | 5.1 KB |
| 한글 100자 + ASCII | 22.6 KB | 14.7 KB | 11.6 KB |
| 한글 300자 + ASCII | 49.5 KB | 28.7 KB | 22.9 KB |
| 한글 800자 + ASCII | 115.5 KB | 59.2 KB | 46.7 KB |
1. TTF (압축 없음)
- 장점: 더 실을 것이 없다. 압축이 없어 결정적인지 따질 것이 없다
- 단점: 가장 크다. 글자가 많은 그림은 WOFF의 두 배다
2. WOFF (zlib)
- 장점: TTF의 절반쯤이다. woff2와 차이는 한글 300자에 6 KB다. 더 싣는 것은 작은 JS 압축 라이브러리 하나와 WOFF 머리를 쓰는 짧은 코드다
- 단점: 압축기의 판을 고정해야 한다. 브라우저에 든 압축기(
CompressionStream)는 브라우저마다 구현이 달라 바이트가 같다고 보장할 수 없으므로 쓰지 않는다
3. woff2 (brotli)
- 장점: 가장 작다
- 단점: woff2 인코더(brotli 압축기와 woff2 변환)를 wasm으로 실어야 한다. 크기는 재지 않았으나 수백 KB로 짐작한다. 인코더의 판을 고정해야 한다
브라우저는 셋을 모두 읽는다. 브라우저가 아닌 그림 도구는 파일 안에 넣은 글꼴을 셋 모두 대개 읽지 않으므로 기준이 갈리지 않는다.
결정
2. WOFF로 넣는다. 압축은 판을 고정한 JS zlib 라이브러리(후보: fflate)로 하고, 압축 수준도 고정한다. 브라우저에 든 압축기는 쓰지 않는다. 메인테이너가 Claude의 추천을 골랐다(2026-11-01).
결과
- 좋아지는 점: 저장 파일의 글꼴이 TTF의 절반쯤이다. 편집기에 더 싣는 코드가 작다
- 감수하는 점: woff2보다 20~25% 크다. 압축 라이브러리의 판을 올리면 같은 모델이라도 바이트가 달라질 수 있으므로, 판을 올릴 때는 시험(같은 모델 → 같은 SVG)이 깨지는지 보고 의도한 변경으로 다룬다
- 후속 작업: 라이브러리를 고르고 판을
package.json에 고정한다. data URI의 MIME은font/woff다 → 2. 문서 구조, 2.2 서브셋 글꼴의 크기