정적 링크 디렉터리 생성기 구조
이 사이트는 CMS 대신 작은 Python 생성기로 정적 HTML을 만듭니다. Markdown은 본문 설명을 담당하고, JSON은 링크 목록과 페이지 메타데이터를 담당합니다. 빌드 스크립트는 두 원본을 조합해 HTML, 사이트별 상세 페이지, sitemap, RSS를 생성합니다.
전체 흐름
content/
data/ JSON 원본 데이터
pages/ Markdown 본문
scripts/
build.py 목록, 상세, sitemap, RSS 생성
build_index.py 홈 대시보드 생성
template.html 공통 HTML 템플릿
생성되는 결과
| 결과물 | 역할 |
|---|---|
index.html |
현재 상태와 방문자 경로를 보여주는 홈 대시보드 |
371.html, 372.html |
기준 목록 페이지 |
/site/.../index.html |
사이트별 상세 리포트 |
sitemap.xml |
전체 URL 목록 |
sitemap-priority.xml |
우선 색인 후보 URL 목록 |
rss.xml |
업데이트 피드 |
robots.txt |
sitemap 위치 안내 |
왜 직접 만들었나요?
일반 블로그 생성기보다 링크 데이터 처리, 주소 변경 이력, 사이트별 상세 페이지 자동 생성이 중요했기 때문입니다. Hugo 같은 생성기도 쓸 수 있지만, 이 사이트에서는 JSON 상속, 상태값, 위험 신호, 우선 sitemap 같은 작은 규칙을 빠르게 바꾸는 편이 더 중요했습니다.
운영 원칙
- 원본 데이터는
content/data에 둡니다. - 설명과 가이드는
content/pages에 둡니다. - 생성된 HTML은 Git에서 추적하지 않습니다.
- GitHub Actions에서 다시 빌드해 GitHub Pages로 배포합니다.
- 날짜는 단순 빌드일보다 실제
last_checked값을 우선합니다.