- 개인 블로그를 기존 보유 도메인 위에 정적 페이지로 구성하고, 콘텐츠 추가와 기본 SEO를 함께 만족하는 최소 구현을 목표로 함
- 구현은 작은
template.html,markdown2, O1에게 요청해 만든render.py, 그리고 Markdown 글 작성으로 단순하게 이어짐 - 템플릿은
system-ui, 최대 폭70ch,color-scheme: light dark,viewport,UTF-8처럼 기본 HTML/CSS만 사용함 render.py는./posts/{post}/eng.md를 HTML로 변환하고 이미지 경로를 조정한 뒤./blog/{post}.html과index.html을 생성함- Jekyll, Ghost, WordPress 없이도 정적 렌더링과 호스팅만으로 운영 가능한 블로그를 만들 수 있음을 보여줌
최소 블로그 요구사항과 실제 구성
- 출발점은 네 가지 요구사항이었음
- 이미 소유한 도메인을 사용할 것
- 현대 웹 표준을 따르고 괜찮은 SEO를 가질 것
- 새 콘텐츠 추가가 매우 쉬울 것
- 모든 페이지가 정적으로 빌드될 것
- 실제 구현 흐름은 단순함
- 작은
template.html작성 pip install markdown2실행- O1에게
render.py스크립트 요청 - 글 작성 후 렌더링하고 호스팅함
- 작은
- Jekyll, Ghost, WordPress 같은 기존 블로그 엔진은 사용하지 않음
템플릿과 렌더링 스크립트
template.html은 기본 HTML 문서 구조와 최소한의 CSS만 담음color-scheme: light dark로 라이트/다크 색상 체계를 지정함- 본문 스타일은
system-ui,sans-serif, 최대 폭70ch, 줄 높이1.5, 글자 크기1.25em으로 설정함 id="head-link"가 붙은 홈 링크와{{ content }}자리표시자를 사용함
render.py는markdown2로 Markdown 글을 HTML로 변환함- 입력 디렉터리는
./posts, 출력 디렉터리는./blog임 - 각 글은
./posts/{post_directory}/eng.md에서 읽음 - 첫 번째
#헤더를 글 제목으로 사용함 fenced-code-blocks,header-ids옵션으로 Markdown을 변환함- 이미지 경로의
<img src="를/posts/{post_code}/기준으로 바꿈 - 템플릿의
{{ content }}를 변환된 HTML로 대체하고 제목 문자열도 글 제목으로 바꿈
- 입력 디렉터리는
- 인덱스 페이지도 같은 스크립트에서 생성함
greetings.md를 먼저 HTML로 변환함- 각 글 제목을 읽어
/blog/{post_code}.html링크 목록을 추가함 - 최종 결과를
index.html로 저장함
- 글은 2025-03-31에 수동으로 작성됨