v1.6.1 — 글 링크 체계: M코드 공식 링크 + 한글 링크 호환 맵
- 일자: 2026-07-19
- 종류: Patch (출판 인프라 보강 + 규약 필드 추가)
배경
Docusaurus 글 URL 이 한글 파일명 slug 그대로여서 공유 시 percent-encoding 으로 길고 깨지기 쉬웠다.
요구: 공식 링크는 M001 식 짧은 넘버링, 기존 공유된 한글 링크는 깨지지 않게.
GitHub Pages(정적 호스팅, 서버 리다이렉트 불가) + Docusaurus 에서 커버 가능한 권장 방식 채택.
변경 사항
| 대상 | 내용 |
|---|---|
manuscript/articles/*.md (11편) | frontmatter code: M001~M011 부여 (order/10) |
copy-from-manuscript.mjs | code → Docusaurus slug/id 주입, 한글slug→M코드 링크 호환 맵(src/data/article-redirects.json) 생성, code 누락 경고 |
docusaurus.config.ts | @docusaurus/plugin-client-redirects@3.10.1 도입 — 구 한글 경로마다 정적 리다이렉트 스텁 생성 |
| 원고 030/040/050 | URL 상대 링크(../NNN-슬러그) 13건 → 파일 상대 링크(./NNN-슬러그.md) 정규화 (종전에도 깨져 있던 형식) |
| [[manuscript-conventions]] | frontmatter code 필드 + code 규칙 절 추가 |
| [[docs-publishing]] | §글 링크 체계 (M코드 + 리다이렉트 구조) 추가 |
검증
npm run build깨진 링크 0 (직전 빌드는 030/040/050 발 broken link 경고 존재)- 빌드 산출물:
/articles/M001~M011정본 페이지 + 구 한글 경로 11개에 리다이렉트 스텁(meta refresh + canonical + JS, query/hash 보존) - 본문 상호 링크·홈 카드·커버 이미지 모두 M코드 URL 로 재작성 확인
유의
- 한 번 발행된 code 는 order 재배열과 무관하게 불변 (공유 링크 정본)
- 실배포 반영은 다음
v*태그 push 시점