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: 압축 라이브러리는 fflate 0.8.3(압축 수준 9 · 메모리 수준 8)으로, 서브세팅은 harfbuzzjs 1.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)에 있다.

문서에 쓰인 글자TTFWOFFwoff2
영어만 (ASCII 95자)9.4 KB6.7 KB5.1 KB
한글 100자 + ASCII22.6 KB14.7 KB11.6 KB
한글 300자 + ASCII49.5 KB28.7 KB22.9 KB
한글 800자 + ASCII115.5 KB59.2 KB46.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 서브셋 글꼴의 크기