doyu.dev
kojaen
2026-11-21

이 사이트는 어떻게 빌드될까

이 사이트에는 프레임워크가 없어요. 대신 Vite 플러그인 하나가 빌드 때 모든 페이지를 만들어요.

흐름

  1. content/ 아래의 Markdown을 읽고 front-matter(제목, 날짜, 요약)를 분리해요.
  2. 본문을 HTML로 바꿔요.
  3. 언어마다 템플릿 함수에 넣어서 /ko/…, /ja/…, /en/… 페이지를 만들어요.
  4. 번역이 없는 글은 다른 언어 버전으로 대신 채우고 안내 문구를 붙여요.

템플릿은 (데이터) => HTML 문자열인 순수 함수예요. 그래서 개발 서버에서는 요청마다 다시 실행하고, 빌드할 때는 같은 함수를 한 번 돌려서 파일로 내보내요.

왜 이렇게 했나

글이 몇 개 안 되는 사이트에는 프레임워크가 과하다고 생각했어요. 그리고 직접 만들면 정적 사이트 생성기가 실제로 무엇을 하는지 눈으로 볼 수 있어요.