sqzass.git

sqzass

~ A static site generator written in Rust
git clone https://github.com/debuman/sqzass.git
commit 35fd132612a643c278cdb8738cba6079e17528cc
parent b9cb002cd6dced47feaac190891e74df1aa55d64
Author: sqzer <110329244+sqzer-x@users.noreply.github.com>
Date: Fri, 31 Jul 2026 22:26:42 +0900

같은 개념을 파일마다 다르게 부르던 것을 정리한다

제목 앵커가 세 이름을 갖고 있었다 — start/_index는 "heading anchor",
markdown은 "anchor", links와 languages는 "앵커". 한국어만 읽는 독자에게 이 셋이
같은 것이라는 보장이 없다. 본문 표기는 "앵커"로 모으고 설정 키
`heading_anchors`만 원문으로 둔다.

`강조`는 단순 통일이 아니라 오역 수정이었다. 이 한 단어가 마크다운 emphasis,
구문 강조, `hl_lines` 줄 표시 셋을 가리키고 있었다. highlighting의 "강조는 줄
경계를 건너 이어집니다"는 바로 위가 `<mark class="hl-line">` 설명이라 "표시한
줄이 다음 줄까지 이어진다"로 읽히는데, 영어 원문의 Highlighting은 구문 강조
쪽이다. 문맥이 흐려지는 자리에서는 "구문 강조"로 적는다.

콜아웃은 절 제목이 "알림 상자", 같은 절 첫 문장이 "콜아웃 문법", 설정 표가
"콜아웃"이었다. 설정 표를 보고 온 독자가 제목과 연결하려면 한 번 더 생각해야
한다. 설정 키가 `alerts`이므로 제목을 "콜아웃"으로 맞추고 키 이름도 본문에
적어 둔다.

벤치마크의 "하이라이팅"과 "빌드 타임"도 나머지 문서가 쓰는 "구문 강조"와
"빌드 시점"으로 맞춘다.

front matter 페이지 제목만 한국어 29개 중 유일하게 소문자로 시작했다. 사이드바와
브레드크럼에 그대로 드러나므로 영문판처럼 대문자로 쓴다 — 본문의 소문자
`front matter`는 개념어이고 이미 전 파일이 일치하니 그대로 둔다.

i18n의 `sections = "문서 갈래"`는 건드리지 않는다. 영문이 "Sections"라
불일치처럼 보이지만 ko.toml은 랜드마크 라벨을 서술형 우리말로 붙이는 규칙을
이미 따르고 있다 — breadcrumb="현재 위치", pagination="이어 보기". "섹션"으로
바꾸면 그 규칙이 이 키에서만 깨진다.

Diffstat:
Mdocs/content/benchmark/_index.ko.md | 2+-
Mdocs/content/content/front-matter.ko.md | 2+-
Mdocs/content/content/markdown.ko.md | 8++++----
Mdocs/content/features/highlighting.ko.md | 3++-
Mdocs/content/start/_index.ko.md | 2+-
5 files changed, 9 insertion(+), 8 deletion(-)

diff --git a/docs/content/benchmark/_index.ko.md b/docs/content/benchmark/_index.ko.md
@@ -61,7 +61,7 @@ toc = true
 
 코드 반복도가 순위를 가르는데, 대부분의 벤치마크는 자기 코퍼스의 반복도를
 말하지 않기 때문입니다. sqzass는 서로 다른 블록만 빌드에서 한 번씩
-하이라이트하므로, 코퍼스 생성기가 같은 블록을 반복해 넣은 코퍼스와 블록이
+구문 강조하므로, 코퍼스 생성기가 같은 블록을 반복해 넣은 코퍼스와 블록이
 전부 다른 코퍼스는 서로 다른 측정입니다 — 187 ms와 1,298 ms의 간격이 바로 그
 변수입니다. 반복도를 밝히지 않은 단일 "heavy" 수치는 결과를 만든 변수를
 숨긴 것입니다.
diff --git a/docs/content/content/front-matter.ko.md b/docs/content/content/front-matter.ko.md
@@ -1,5 +1,5 @@
 +++
-title = "front matter"
+title = "Front matter"
 description = "페이지가 가질 수 있는 모든 필드와 그 역할"
 weight = 10
 toc = true
diff --git a/docs/content/content/markdown.ko.md b/docs/content/content/markdown.ko.md
@@ -20,9 +20,9 @@ cjk_friendly_emphasis = true
 heading_anchors       = "right"   # none | left | right
 ```
 
-## 알림 상자
+## 콜아웃
 
-인용문 위에 얹힌 GitHub의 콜아웃 문법입니다.
+인용문 위에 얹힌 GitHub의 콜아웃 문법입니다. 설정 키는 `alerts`입니다.
 
 ```markdown
 > [!NOTE]
@@ -70,9 +70,9 @@ heading_anchors       = "right"   # none | left | right
 
 ## 제목
 
-모든 제목에 `id`가 붙습니다. anchor를 보여주든 말든 붙는데, 목차와 남에게
+모든 제목에 `id`가 붙습니다. 앵커를 보여주든 말든 붙는데, 목차와 남에게
 건네는 딥링크가 둘 다 여기에 기대기 때문입니다. 같은 제목이 반복되면 `-1`, `-2`가
-붙고, anchor와 목차 항목은 반드시 일치합니다. 한 번의 순회에서 같은 카운터로
+붙고, 앵커와 목차 항목은 반드시 일치합니다. 한 번의 순회에서 같은 카운터로
 만들어지니까요.
 
 `heading_anchors`는 눈에 보이는 `#` 링크를 정합니다. `"right"`(기본), `"left"`,
diff --git a/docs/content/features/highlighting.ko.md b/docs/content/features/highlighting.ko.md
@@ -77,7 +77,8 @@ fn main() {
 `hl_lines`는 1부터 세는 줄 번호와 닫힌 구간을 쉼표로 나열합니다:
 `hl_lines=2-4,7`. 지목된 줄은 `<mark class="hl-line">`로 감싸집니다.
 `<mark>`는 브라우저가 기본으로 칠해 주므로 CSS가 하나도 없어도 표시가 보이고,
-사이트는 `.highlight mark`로 다시 꾸미면 됩니다. 강조는 줄 경계를 건너 이어집니다.
+사이트는 `.highlight mark`로 다시 꾸미면 됩니다. 구문 강조는 줄 경계를 건너
+이어집니다.
 여러 줄 주석의 가운데 줄만 표시해도 그 줄은 여전히 주석입니다.
 
 `name`은 블록에 파일명을 답니다. 마크업이 아니라 속성으로 나가므로 —
diff --git a/docs/content/start/_index.ko.md b/docs/content/start/_index.ko.md
@@ -16,7 +16,7 @@ sort_by = "weight"
 
 ## 왜 sqzass인가
 
-**마크다운을 트리에서 변환합니다.** 링크 재작성, heading anchor, 목차가 모두
+**마크다운을 트리에서 변환합니다.** 링크 재작성, 제목 앵커, 목차가 모두
 [comrak]의 AST 연산입니다. 흔한 지름길인 "완성된 HTML에 정규식 돌리기"는 속성이
 홑따옴표이거나 따옴표가 없는 요소를 조용히 건너뛰고, 그 사실은 프로덕션에서
 알게 됩니다.