~/blog/tour/ko.mdx
블로그 둘러보기: 다이어그램, 수식, 코드
첫 글입니다. 이 블로그가 글 안에 담을 수 있는 것을 하나씩 보여 드립니다. 읽는 자리를 따라오는 그림, 빌드할 때 그리는 다이어그램, 수식, 코드, 그리고 두 언어.
이 블로그는 제 노트입니다. 대부분 기술 이야기이고, 일하다 생긴 잡다한 것도 올립니다. 모든 글은 한국어와 영어로 함께 씁니다. 첫 글은 이 블로그 자체를 둘러봅니다. 아래의 그림과 수식과 코드는 모두 이 블로그의 빌드가 실제로 만든 결과이고, 숫자는 모두 이 블로그를 만들면서 잰 값입니다.
읽는 자리를 따라오는 그림
설명이 그림을 가리킬 때, 그림은 보통 몇 문단 위에 있습니다. 여기서는 그림이 옆에(휴대폰에서는 위에) 고정되고, 지금 읽는 단계가 가리키는 부분만 밝아집니다. 아래는 글 한 편이 페이지가 되는 경로입니다.
글은 MDX 파일입니다. remark가 마크다운을 구문 트리로 바꾸고, 이때 $로 감싼 수식과 mermaid 코드 블록도 각자 트리의 노드가 됩니다.
rehype-katex가 수식을 KaTeX HTML로 바꿉니다. 읽는 사람은 수식 엔진이 아니라 글꼴만 내려받습니다.
rehype-mermaid가 다이어그램 블록을 beautiful-mermaid로 그려 SVG로 끼워 넣습니다. 색은 CSS 변수로 남겨 두어서, 테마를 바꾸면 다시 그리지 않고 색만 바뀝니다.
그림이 된 블록은 더 이상 코드 블록이 아니므로, Expressive Code는 남은 코드만 하이라이트합니다.
Astro가 페이지로 묶습니다. 이 글의 그림과 수식은 모두 이 경로로 왔습니다.
beautiful-mermaid는 flowchart, state, sequence, class, ER, xychart 여섯 가지를 그립니다.1 gantt나 pie 같은 나머지는 그 종류가 있는 페이지에서만 브라우저가 mermaid를 받아서 그립니다.
다이어그램
이 블로그를 만들면서 배포 폴더의 크기를 du -sh로 쟀습니다. 처음에는 브라우저용 mermaid가 번들에 통째로 들어가 12MB였습니다. mermaid를 필요한 페이지에서만 CDN으로 받게 바꾸고, 하네스 페이지를 배포에서 빼자 5.3MB가 됐습니다. 수식용 KaTeX 글꼴과 이 글을 더한 지금은 5.9MB입니다.
지금 배포되는 파일을 종류별로 나누면 다음과 같습니다. 대부분은 글꼴인데, 한글 글꼴은 글자 범위별로 잘게 나뉘어 있어서 브라우저는 페이지에 실제로 나온 글자가 든 조각만 내려받습니다. 이 원 그래프는 beautiful-mermaid가 그리지 않는 종류라서, 이 페이지에서만 브라우저가 mermaid를 받아 그렸습니다.
pie title 배포 파일 구성 (KB) "글꼴" : 5111 "자바스크립트" : 15 "CSS" : 173 "HTML과 기타" : 283
글 한 편이 공개되기까지의 과정도 그림 하나로 그립니다.
수식
수식은 $…$로 쓰면 문장 안에, $$…$$로 쓰면 한 줄을 따로 차지합니다. 예를 들어 Redis의 HyperLogLog는 레지스터를 개 쓰고, 표준 오차는 다음과 같습니다.
이 블로그의 읽기 시간도 식으로 셉니다. 한국어는 공백을 뺀 글자 를 분당 500자로, 영어는 단어 를 분당 230단어로 읽고, 코드는 줄을 분당 40줄로 훑는다고 봅니다.
화면 아래 상태 줄의 남은 시간은 이 를 절마다 나눠서 셉니다. 절마다 같은 방식으로 무게 를 구하고(그림 하나에 0.3분을 더합니다), 그 절을 읽은 비율 만큼 덜어 냅니다. 는 화면 위에서 30% 지점에 있는 읽는 선이 그 절을 얼마나 지났는지입니다. 그래서 글 맨 위에서는 남은 시간이 제목 아래의 읽기 시간과 같습니다.
코드
코드 블록은 Expressive Code가 그립니다. 파일 이름, 줄 강조, diff, 터미널 창, 접기를 씁니다. 아래 diff는 이 블로그를 만들다가 실제로 고친 한 줄입니다.
.replace(/\bid="([^"]*)"/g, `id="${id}-$1"`).replace(/(?<=\s)id="([^"]*)"/g, `id="${id}-$1"`)\bid=는 data-id=의 -와 i 사이도 단어 경계로 보기 때문에 노드 이름까지 바꿔 버렸고, 그래서 위의 워크스루가 밝힐 노드를 찾지 못했습니다. 지금은 앞에 공백이 있는 id=만 고릅니다. 이 함수 전체도 워크스루로 읽을 수 있습니다.
export function drawDiagram(src, id) { return renderMermaidSVG(src, { bg: 'var(--bg)', fg: 'var(--fg)', transparent: true }) .replace(/<style>[\s\S]*?<\/style>/g, '') .replace(/^(<svg[^>]*?) style="[^"]*"/, '$1') .replace(/(?<=\s)id="([^"]*)"/g, `id="${id}-$1"`) .replace(/url\(#([^)]+)\)/g, `url(#${id}-$1)`)}그리는 쪽은 한 줄입니다. 색 자리에 실제 색 대신 var(--bg)를 넘깁니다.
SVG마다 들어 있는 <style>을 뺍니다. 같은 규칙이 그림 수만큼 반복되고, Google Fonts에서 Inter를 불러오는 @import도 들어 있기 때문입니다. 규칙은 diagram.css에 한 번만 둡니다.
SVG 자신에 붙은 --bg: var(--bg)를 지웁니다. 자기 자신을 참조하는 변수는 순환이 되어 값이 사라집니다.
화살촉 marker의 id에 그림마다 다른 접두사를 붙입니다. 접두사가 없으면 모든 그림이 #arrowhead 하나를 나눠 쓰는데, 그 첫 그림이 숨겨진 언어 쪽에 있으면 나머지 그림의 화살촉이 함께 사라집니다.
글을 쓰고 공개하는 일은 터미널 명령 네 개로 끝납니다.
$ npm run new -- tour "블로그 둘러보기" "A tour of this blog"$ npm run dev$ npm run check$ npm run deploy:site코드 글꼴은 IBM Plex Mono에 IBM Plex Sans KR의 한글을 정확히 두 칸 폭으로 합친 Monoplex KR입니다. 한글이 두 칸이 아니면 아래 상자가 어긋납니다.
┌──────────────┬──────────┐│ 단계 │ 결과 │├──────────────┼──────────┤│ 마크다운 │ ko.mdx ││ 수식 │ HTML ││ 그림 │ SVG │└──────────────┴──────────┘원본 글꼴은 굵기마다 2.7MB입니다. 빌드는 이 저장소에 쓰인 한글만 남깁니다. 이 글을 쓴 시점에는 한글 406자, 굵기마다 25.5KB였습니다.
남의 코드를 옮겨 올 때는 펜스에 link="URL"을 붙입니다. 파일 이름 자리가 원본으로 가는 링크가 되고, GitHub 주소면 GitHub 아이콘이 앞에 붙습니다. 커밋 해시가 들어간 주소를 쓰면 원본이 바뀌어도 줄 번호가 맞습니다. 아래는 Redis 7.2.16의 eviction 코드 일부입니다.
if (server.maxmemory_policy & MAXMEMORY_FLAG_LRU) { idle = estimateObjectIdleTime(o);} else if (server.maxmemory_policy & MAXMEMORY_FLAG_LFU) { idle = 255-LFUDecrAndReturn(o);} else if (server.maxmemory_policy == MAXMEMORY_VOLATILE_TTL) { idle = ULLONG_MAX - (long)dictGetVal(de);} else { serverPanic("Unknown eviction policy in evictionPoolPopulate()");}정책이 무엇이든 점수는 클수록 먼저 내보낼 후보입니다. LFU는 빈도를 255에서 빼서 같은 방향으로 맞춥니다. 원본의 긴 주석은 줄였습니다.
만져 보는 그림
글에 따라 직접 눌러 보는 그림이 들어갑니다. 모두 빌드할 때 HTML로 나오고, 자바스크립트는 재생과 버튼만 맡습니다. 아래는 각 그림의 견본이고, 제자리에서 쓰인 모습은 링크한 글에 있습니다.
정렬 그림은 같은 입력을 두 알고리즘에 나란히 넣고 한 단계씩 움직입니다. 입력 메뉴로 무작위, 이미 정렬된 배열, 중복이 많은 배열을 바꿔 볼 수 있습니다. 정렬 글에서 Rust, C++, Go가 실제로 쓰는 알고리즘까지 이어집니다.
같은 키를 가진 원소의 순서가 정렬 뒤에도 남는지는 그림으로 보는 편이 빠릅니다.
입력 순서
- 2#1
- 1#2
- 2#3
- 1#4
- 2#5
- 1#6
불안정 · Lomuto 퀵소트
- 1#6
- 1#4
- 1#2
- 2#1
- 2#3
- 2#5
안정 · Rust 병합 정렬
- 1#2
- 1#4
- 1#6
- 2#1
- 2#3
- 2#5
순서가 중요한 이야기는 단계 재생기로 씁니다. 표의 열이 상태이고, 버튼이나 방향키로 한 단계씩 넘깁니다. 위에 있는 트랙 버튼은 같은 시작점에서 갈라지는 다른 경우입니다. 아래는 다음 절에서 다룰 l 키를 이 형식으로 옮긴 것입니다.
l 키를 누르면
읽는 중
한국어 본문의 세 번째 절을 40%쯤 읽고 있습니다.
전체 상태 보기 (JavaScript 없이도 읽을 수 있습니다)
한국어에서 영어로
- 읽는 중
data-lang: ko · 읽던 자리: 3절 · 40% · 보이는 글: 한국어
한국어 본문의 세 번째 절을 40%쯤 읽고 있습니다.
- l 키
data-lang: ko · 읽던 자리: 3절 · 40% · 보이는 글: 한국어
chrome.js가 키를 받고 reader.js에 지금 위치를 묻습니다.
- data-lang 전환
data-lang: en · 읽던 자리: 3절 · 40% · 보이는 글: 영어
html 속성 하나만 바뀝니다. 페이지를 다시 불러오지 않습니다.
- 같은 자리로
data-lang: en · 읽던 자리: 3절 · 40% · 보이는 글: 영어 3절
영어 본문의 세 번째 절, 40% 지점으로 스크롤합니다.
다시 l 키
- 읽는 중
data-lang: en · 읽던 자리: 3절 · 70% · 보이는 글: 영어
영어로 조금 더 읽어 같은 절의 70%에 왔습니다.
- l 키
data-lang: en · 읽던 자리: 3절 · 70% · 보이는 글: 영어
이번에도 위치를 먼저 묻습니다.
- data-lang 전환
data-lang: ko · 읽던 자리: 3절 · 70% · 보이는 글: 한국어
숨어 있던 한국어가 다시 보입니다.
- 같은 자리로
data-lang: ko · 읽던 자리: 3절 · 70% · 보이는 글: 한국어 3절
처음 떠난 40%가 아니라 지금 읽던 70%로 돌아옵니다.
데이터 구조 내부를 보여 줄 때는 그 구조만을 위한 그림을 만듭니다. 아래는 Redis 캐시 글의 근사 LRU 그림입니다.
정확한 LRU
최근 절반 비율 100%
samples 1
최근 절반 비율 53.6%
samples 3
최근 절반 비율 84.5%
samples 5기본값
최근 절반 비율 92%
samples 10
최근 절반 비율 96.6%
비트 단위 규칙은 직접 비트를 눌러 확인합니다. HyperLogLog 글에서 쓰는 그림입니다.
이 해시는 어느 레지스터를 바꿀까요?
하위 14비트: 레지스터남은 50비트: 연속된 0의 수 + 1
14번 비트에서 63번 방향으로 읽습니다.
- 레지스터 번호
- 42
- 후보 값
- 5
- max(기존 값, 후보 값)
- 5
후보 값 5는 기존 값 5와 같습니다. 레지스터는 바뀌지 않습니다.
글 중간에는 짧은 확인 문제가 들어갑니다. 고르면 바로 정답과 이유가 나오고, 보기 순서는 불러올 때마다 섞입니다.
퀴즈이 블로그를 확인합니다
답을 고르면 해설이 나옵니다.
2문제 중 0개 맞힘
l키로 언어를 바꿀 때 일어나는 일은 무엇입니까?한 페이지에 두 언어가 다 들어 있습니다. 그래서 두 언어의 절 수가 다르면 빌드가 실패합니다.
좁은 화면에서 각주를 누르면 어떻게 됩니까?
예전에는 글 끝으로 뛰어서 어디서 왔는지 놓치기 쉬웠습니다. 지금은 읽던 자리에서 내용을 보여 줍니다.
글 끝에는 외울 거리를 카드로 묶습니다. 누르면 뒤집힙니다.
단축키와 그림
카드를 누르면 뒤집힙니다.
읽는 사람을 위한 것
넓은 화면에서 왼쪽 목차는 절마다 그 길이만큼 막대를 그리고, 읽은 만큼 채웁니다. 화면 아래 상태 줄은 지금 읽는 절과 남은 시간을 보여 주고, 왼쪽의 파일 이름을 누르면 이 글의 원문 마크다운이 열립니다. 그림은 누르면 크게 볼 수 있습니다.
| 키 | 하는 일 |
|---|---|
| t | 밝은 테마와 어두운 테마 |
| l | 한국어와 영어, 읽던 자리 유지 |
| [ ] | 이전 절과 다음 절 |
| ? | 단축키 목록 |
l을 눌러 보세요. 한 페이지에 두 언어가 다 들어 있어서 다시 불러오지 않고, 지금 읽는 절의 같은 위치로 옮겨 갑니다.
l 키는 chrome.js가 받습니다. 모든 페이지에 들어 있는, 언어와 테마를 맡은 스크립트입니다.
언어를 바꾸기 전에 reader.js에 지금 위치를 묻습니다. 답은 절 번호와 그 절을 읽은 비율입니다.
html의 data-lang을 바꾸면 숨어 있던 언어가 보이고 보이던 언어가 숨습니다. 아무것도 다시 불러오지 않습니다.
reader.js가 새 언어의 같은 절, 같은 비율 지점으로 스크롤합니다. 그래서 두 언어의 절 수가 다르면 빌드가 실패합니다.
넓은 화면에서는 각주가 본문 옆 여백에 놓입니다.2 새 글은 RSS(한국어, 영어)로 받아 볼 수 있고, 에이전트에게 읽힐 때는 llms.txt에서 시작하면 됩니다.