Pages

Astro 파일 기반 라우팅. 각 .astro 파일이 하나의 페이지 경로에 대응.

페이지 구조

동적 라우트

거란어 관련 (khitan/)

모든 거란어 페이지는 /khitan/ 아래로 통합 (구 /kss, /kssIME는 astro.config.ts의 redirects로 301).

dev 전용 편집 API: api/khitan/glossary.ts, api/khitan/kls.ts (prod에선 403).

포트폴리오 홈 시안 (lab/, dev 전용)

블로그 홈을 프로젝트 포트폴리오로 바꾸기 위한 시안. ① 板本은 2026-09-29 홈 index.astro로 옮겨 공개했다(LabShell의 public prop으로 검색·OG 메타, 정적 prerender). ②·③은 참고용으로 보존. /lab은 src/utils/devOnlyRoutes.ts에 등록돼 운영에선 404이며, 각 페이지는 prerender = false. 헤더 없는 LabShell.astro 레이아웃을 쓴다.

板本 동작:

• 입체 판: 판면(앞면)과 오른쪽 옆면으로 된 CSS 3D 블록(.pb-block)이다. WebGL 3D는 쓰지 않는다.
  • 첫 방문에는 ‘세반시옷’이 적힌 옆면만 가운데 서 있다. 누르면 1.8초 동안 돌아서 판면이 나온다. 클릭은 돌지 않는 투명 영역(.pb-hit)이 받는다. 올라가면 판이 살짝 돌아 앞면을 엿보이지만(is-peek), 커서 아래 판정은 그대로다.
  • 두 번째 방문부터(localStorage pb-seen)는 처음부터 판면이 열려 있다.
  • 우상단 아이콘 버튼 둘: 옆면↔판면 돌리기, 명암 전환.
  • 두 면의 accent 망점 음영(.pb-shade 캔버스, 45°·5px)은 판의 실제 회전각을 읽어 그 면이 정면에서 돌아간 만큼만 보인다(판면 θ/55°, 옆면 (90°−θ)/22°). 어느 면이든 정면을 똑바로 볼 때는 0이다. 판면은 모서리에서 멀수록, 옆면은 모서리 쪽에만 점이 굵다. 회전각은 판이 도는 동안(transitionrun~transitionend)에만 매 프레임 읽는다.
  • 도는 동안에는 판면이 스스로 종이색을 칠한다(is-solid). 다 돌면(transitionend → is-settled) 물 캔버스가 반전 영역을 넘겨받는다.
• 펼치기: 오른쪽 반엽에 卷首·部·類가 있다. 하나를 누르면 그 갈래가 판심 쪽으로 붙고, 하위 항목이 판심에서 왼쪽 반엽으로 흘러나온다. 다시 누르거나 Esc를 누르면 한 단계 접힌다.
• 첫 면 = 서문 + 목록: 판심 오른쪽 반엽은 한문 서문 「三日母字序」(PREFACE)이다. 세반시옷 = ㅿ(半齒, 韻書의 日母) 셋이라 三日母字다. 서문에는 이름·내력·체재·목적만 적고 개별 주제는 언급하지 않는다. 날짜는 음력으로 적는다(開設 丙午正月, 撰 丙午仲秋). 한 덩이 글이 세로쓰기 행을 따라 흐르고, 행 폭은 계선 간격과 같다. 목록은 제목 「部類總目」 아래 部·類를 판심 너머 왼쪽 반엽에 판심 쪽부터 싣는다. 두 제목은 두 글자 들여쓰고 본문은 頂格이다. 항목을 누르면 서문은 밀려나 사라지고(is-reading), 오른쪽 반엽에 고른 갈래, 왼쪽에 하위가 놓인다.
• 조판(『廣韻』 目錄 참조): 첫 면은 部 행 다음에 類를 한 행 위아래 두 칸(上下段)으로 둘씩 싣는다. 서수 「第N」은 部에만 붙인다. 표제는 행 폭의 74% 크기로 빽빽하게 조판한다.
  • 할주(.pb-w)는 띄어쓰기 없이 두 줄로 흘러내린다. 두 줄 폭 = 큰 글자 한 자 폭이다(0.45em × 2). 줄은 마크업에서 글자 수의 절반으로 미리 가른다(warichuLines, 오른쪽 줄이 먼저·홀수면 한 자 길게). 대체 글꼴 글자가 섞여 세로 폭이 달라져도 세 줄이 되지 않는다.
  • 할주 내용은 projects.ts의 한문 note, 데이터에서 센 규모, sources 경로의 마지막 git 커밋 달(간지, 예: 丙午九月補)이다. 部는 「凡N類N種 內未刊 收字」를, 類는 하위 항목별 규모를 적는다.
• 판심: 가는 경계선 둘, 細黑口, 곡선 홈을 판 上下內向 黑魚尾(accent). 가운데에는 七十二候를 적는다. 브라우저가 태양 황경을 계산해 立春(315°)부터 5°마다 候를 가르므로, 절기 경계에 맞춰 닷새쯤마다 바뀐다(예: 秋分 初候 雷始收聲).
• 호버: 글자마다 차례로 -webkit-text-stroke가 불어나 굵어진다.
• 물(WebGL2): 하나의 높이장 L = max φ의 등고선이다. φ = (물마루 반지름 − 거리)/34px이다.
  • 셰이더의 파원은 선분이다(점은 길이 0). 선분 위 각 점이 지나간 순간부터 퍼지는 원판의 합집합을 닫힌 식으로 구한다. 다만 지금은 점 파원만 쓴다.
  • 커서는 150px 이상, 0.3초 이상 움직일 때마다 물방울 하나를 떨군다. 이어지는 물살은 사용자가 싫어해서 뺐다.
  • 누른 자리는 0.42초마다 솟는 샘이다. 5초 동안 가만히 있으면 빈 물에 빗방울이 떨어진다.
  • 만난 물결은 고리마다 합집합의 바깥 외곽선만 남고, 고리 5개 안쪽의 심은 비어 있다.
  • 판면 밖은 一文字ぼかし 띠를 얹은 accent 그라데이션 위에 보카시를 45° 망점으로 찍는다. 판면 안은 종이 위에 등고선만 그린다.
• 판면 글꼴: 朱雀仿宋 v0.212(TrionesType, OFL 1.1, 예약 글꼴 이름 없음)를 쓴다.
  • 페이지 글자만 뽑은 부분 글꼴 public/fonts/lab/ZhuqueFangsong-panbon.woff2이고, 라이선스는 public/fonts/lab/OFL-ZhuqueFangsong.txt다. 원본 TTF는 저장소 밖(~/Documents/석사 연구/.../zhuque-fangsong/v0.212/)에 있다. 글자가 바뀌면 python3 scripts/fonts/panbon_font.py zhuque로 다시 뽑는다.
  • 원본에 세로 메트릭(vmtx)이 없어서, 그대로 두면 브라우저가 한 자를 1.4em으로 잡아 글자가 벌어진다. 스크립트가 한 자 = 1em의 vhea·vmtx를 넣는다(--adv: 1).
  • 대체 글꼴이 끼지 않게 글을 이 글꼴의 글자로만 적는다. 서문의 ㅿ은 「半齒之字」로 풀고, 旣淸硏鄕은 既清研鄉으로 쓴다. 七十二候의 새 이름은 이칭으로 바꾼다: 鶡鴠→盍旦(『禮記』 坊記), 鴽→鶉(『列子』 天瑞), 鵙→伯勞(『爾雅』 釋鳥). 할주 권점 ○는 글꼴에 없어 CSS 원으로 그린다. 한글(옆면의 세반시옷)만 Gowun Batang으로 넘어간다.
  • 이체자 기능이 없어 공통 코드포인트는 중국 규범 자형이고, 번체 고유 글자(爲 黃 說 등)는 전통 자형이다.
  • 할주는 0.45em(두 줄 폭 0.9em = 글자 실제 폭)이다. 0.5em이면 上下段의 契丹 할주가 칸 밖으로 넘친다.
  • 錦華明朝體 C(茉莉字型, 개인·비상업 사용권)도 panbon_font.py jinhua로 뽑을 수 있다(ss01 傳承字形을 cmap에 건다, 결과는 git에서 빠진 private/). 다만 GB2312 + 82자라 판면 한자의 27%가 없어 쓰지 않는다. Noto·대만 자형(TC)·송명(Song Myung)은 쓰지 않는다.

프로젝트 정본은 src/data/projects.ts의 catalog 트리(部 › 類 › 書, 契丹 › 小字만 한 층 더). 같은 항목을 두 자리에 싣을 때(互著)는 두 번째에 sameAs로 원래 id를 가리킨다. 잎 노드의 status는 open(링크) · sealed(목록만, 펼치면 墨釘 — 詩帖) · forthcoming(未刊 — 張皇地名). projects는 잎을 펼친 목록(시안 ②·③용). 수치는 src/lib/projectSpecimens.ts가 빌드 때 데이터에서 센다.

시첩 /sichep(구 /sichyep)은 2026-09-29부터 공개다(정적 prerender). 작품 데이터는 src/data/sichyep.ts, 하이쿠 작업실 /haiku는 여전히 dev 전용.

폐기한 프로젝트 /rarecjk(+/api/rarecjk)와 /chimyong-ekimei는 2026-09-26부터 dev 전용이다(운영 404, 허브 링크도 dev에서만 노출).

레이아웃 (src/layouts/)

판식 BookShell (2026-09-29~)

목록(src/data/projects.ts)에 걸린 독립 페이지는 모두 BookShell로 뜬다: /hanqca/woyca, /twongswokca, /khitan/resources, /khitan/kls, /khitan/kss, /khitan/ime, /toponym/cwosachel, /sichep. (/hasui는 아직 자체 HTML 문서 — 이식 전.)

• 서책 지면이 화면 전체, 위아래 여백 없음(본문을 온전히 보이게). 화면 양 끝에 반쪽 판심을 위아래 끝까지 붙인다(오른쪽: 표제, 왼쪽: 部·類 — node id로 trailOf()에서 읽음). 판심과 본문은 가는 계선 하나로 갈린다. 물(파문)은 쓰지 않는다.
• 스크롤바: 화면 맨 위 가로 전체의 진행 막대, accent(6px). 왼쪽이 처음 — 아래로 읽은 만큼 왼쪽부터 accent가 차오른다. 누르거나 끌어 그 비율 자리로 스크롤. 네이티브 스크롤바는 숨긴다.
• 오른쪽 판심 상비 자리에 홈 단추·명암 단추. Header·Footer·BackButton은 쓰지 않는다.
• 모바일(≤640px): 판심 생략, 단추는 스크롤바 아래 오른쪽 위에 띄운다.
• 문서 스크롤은 그대로(창 스크롤 스크립트 호환). 한 화면짜리 앱은 flush prop으로 본문 칸을 고정한다(시첩).
• 기본은 가로쓰기·줄칸 없음. 세로쓰기는 페이지가 스스로(시첩).
• 시첩(sichep.astro)은 세로쓰기 책이라 오른쪽이 처음이다: 스크롤러·시간축 모두 direction: rtl(원점이 오른쪽 끝, scrollLeft는 왼쪽으로 갈수록 음수)이고, DOM은 읽는 차례(오래된 것이 먼저)로 담아 긁어 복사해도 그 차례로 나온다. 시의 전문(.visually-hidden)은 복사에서 빼고(user-select: none) 눈에 보이는 두 줄만 복사된다. 마우스 휠(세로)은 가로 스크롤로 바뀌어 아래로 돌리면 읽는 쪽(왼쪽)으로 가고, 스크롤 멈춤(scroll-snap)은 쓰지 않는다(끄는 동안 뚝뚝 끊겼다).
  • 시첩 시간축(위쪽 막대)은 시각 축이다: 음력 浣을 Intl(chinese 달력)로 양력 10일 구간으로 옮기고, 그 위에 七十二候 경계(src/lib/seasons.ts, 홈 판심과 같은 데이터)를 눈금으로 긋는다. 浣 구간은 길 위의 마디(눌러서 이동), 읽은 만큼은 accent로 차고, 머리(손잡이)가 지금 자리를 가리키며, 위에 “浣 · 節氣 차례 候名”이 뜬다. 스크롤 거리 ↔ 시각은 닻(처음·각 浣이 화면 한가운데 올 때·끝)을 직선으로 이은 것이다. 눈금이 12개를 넘으면 候 이름을, 30개를 넘으면 節氣 아닌 눈금의 차례도 숨긴다(data-density). 정확한 작성일은 저장소에 없다 — 얻는 것은 浣의 10일 구간뿐이다.
• 공통 색·글꼴 토큰: src/styles/panbon.css(--pb-*, 朱雀仿宋 부분 글꼴).

데이터 소스 (src/data/)