문서도 코드, 이제 그래프도 코드로 — Typst용 '그래픽 문법' Gribouille 0.3.0

코드로 문서 쓰는 시대, 그래프도 코드로

혹시 Typst라고 들어보셨어요? 요즘 LaTeX를 대체하겠다고 등장한 신생 조판(문서 레이아웃을 만드는 일) 시스템이에요. LaTeX가 뭐냐면, 논문이나 수식 많은 책을 만들 때 쓰는 전통의 도구인데요, 강력한 대신 문법이 어렵고 컴파일도 느린 걸로 악명이 높거든요. Typst는 Rust로 만들어져서 컴파일이 눈 깜짝할 사이에 끝나고, 문법도 마크다운처럼 훨씬 직관적이라 최근 학계랑 개발자들 사이에서 빠르게 자리를 잡아가고 있어요.

그런데 문서를 쓰다 보면 결국 그래프나 차트가 필요하잖아요. 지금까지 Typst에서 차트를 그리는 건 좀 번거로운 편이었는데, 여기에 'Gribouille'라는 패키지가 0.3.0 버전을 내놨어요. 이게 단순한 차트 그리기 도구가 아니라 'Grammar of Graphics(그래픽 문법)'라는 개념을 Typst 안에 그대로 옮겨왔다는 게 핵심이에요.

'Grammar of Graphics'가 뭐냐면

그래픽 문법은 R을 쓰는 분이라면 ggplot2로 익숙한 그 사고방식이에요. 쉽게 말하면, 차트를 '막대그래프 그려줘'처럼 통째로 주문하는 게 아니라, 레이어를 쌓아서 만드는 방식이거든요.

순서를 풀어보면 이래요. 먼저 "이 데이터를 쓸 거야"라고 데이터를 연결하고요, 그다음 "x축에는 이 열, y축에는 저 열, 색깔은 이 카테고리로 구분해줘"라고 데이터의 각 항목을 시각적 요소에 매핑해요. 이걸 aesthetic mapping(미적 매핑)이라고 부르는데, 말이 거창하지 그냥 '어떤 값을 어떤 시각 요소로 보여줄지 짝지어주는 것'이에요. 그러고 나서 "점으로 찍을까, 선으로 이을까, 막대로 세울까" 같은 geometry(도형)를 얹고, 축의 눈금이나 색 스케일을 조정하면 차트가 완성돼요.

장점이 뭐냐면, 한 번 데이터와 매핑을 정의해두면 도형만 바꿔서 산점도를 선그래프로, 막대그래프로 손쉽게 바꿀 수 있다는 거예요. 차트 종류마다 새 함수를 외울 필요가 없는 거죠. 데이터를 '그림으로 번역하는 규칙'을 배우는 셈이라, 한 번 익히면 응용이 정말 자유로워져요.

Gribouille가 특별한 이유

기존에도 Typst에는 cetz나 plotst 같은 그리기 라이브러리가 있었어요. 그런데 이런 도구들은 대체로 '여기에 선 긋고, 저기에 점 찍어라' 같은 명령형에 가까워서, 복잡한 차트를 만들려면 손이 많이 갔거든요. Gribouille는 거기서 한 단계 위로 올라가서, "데이터와 매핑만 선언하면 나머지는 알아서 그려줄게"라는 선언형 접근을 택했어요. 그래서 코드가 훨씬 짧고 의도가 명확해져요.

게다가 Typst 네이티브 패키지라서 별도의 외부 프로그램이나 이미지 파일이 끼어들지 않아요. 데이터가 바뀌면 문서를 다시 컴파일하는 것만으로 그래프가 자동으로 갱신되거든요. 이게 생각보다 큰 장점인데, 보고서를 매주 새 데이터로 찍어내야 하는 상황이라면 '데이터만 갈아끼우면 차트가 알아서 바뀌는' 워크플로우가 엄청난 시간 절약이 되니까요.

업계 흐름 속에서 보면

이건 사실 '재현 가능한 문서(reproducible document)'라는 큰 흐름의 한 조각이에요. R 진영엔 R Markdown과 Quarto가 있고, 파이썬 쪽엔 Jupyter가 있죠. 다들 '데이터 분석 코드와 그 결과 그래프, 그리고 설명 글을 한 파일에 담아 항상 똑같이 재생산하자'는 목표를 공유해요. Gribouille + Typst 조합은 여기에 'LaTeX만큼 예쁜 출력물을 훨씬 빠르고 쉽게'라는 매력을 더한 거예요. matplotlib처럼 이미지를 따로 만들어 붙이는 게 아니라, 문서 엔진 자체가 그래프까지 그려준다는 점에서 통합도가 한 단계 높고요.

한국 개발자에게 주는 의미

당장 모두가 쓸 도구는 아니에요. 하지만 기술 문서, 사내 리포트, 논문, 데이터 정기 보고서를 다루는 분이라면 Typst 자체가 충분히 배워둘 가치가 있어요. 컴파일이 빠르고 문법이 쉬워서 'LaTeX는 어려워서 못 쓰겠다'던 분들도 진입이 쉽거든요. 거기에 Gribouille까지 익히면, 매번 엑셀이나 외부 툴에서 차트를 만들어 캡처해 붙이는 수작업에서 벗어날 수 있어요. 특히 데이터가 자주 바뀌는 자동화 리포트 파이프라인을 만든다면, '코드 한 번 짜두면 끝'인 이 방식이 진가를 발휘할 거예요.

마무리

핵심은 이거예요 — "차트를 그리지 말고, 데이터를 그림으로 번역하는 규칙을 선언하라." 그게 그래픽 문법의 철학이고, 이제 Typst에서도 그게 가능해졌어요.

여러분은 보고서나 문서의 차트를 지금 어떻게 만들고 계세요? 엑셀 캡처파, matplotlib 이미지파, 아니면 이미 Typst나 Quarto 같은 코드 기반 문서로 넘어가셨나요? 경험 나눠주시면 좋겠어요.