최소 기능 블로그 (Minimum viable blog)

4 hours ago 1

Jekyll, Ghost, WordPress 없이 직접 블로그 제작한 사례임
기본 요구 조건은 소유한 도메인 사용, 정적 사이트 생성, SEO 준수, 간편한 게시글 추가 등임
핵심 구성은 template.html과 render.py 스크립트, 마크다운 기반 글 작성만으로 모든 페이지를 자동 렌더링함
markdown2 파이썬 라이브러리를 활용해 마크다운 → HTML 변환 및 페이지 생성을 자동화함
SEO와 현대 웹 표준을 준수하면서도 간단하게 콘텐츠를 추가할 수 있는 구조를 강조함

블로그 요구 조건

기존 소유 도메인을 사용할 것
현대적 웹 표준 및 SEO 친화성 유지
글 추가가 매우 쉬울 것
모든 페이지는 정적으로 생성될 것

구현 절차 요약

template.html 파일 작성 → 기본 HTML 레이아웃 구성
pip install markdown2 명령어로 마크다운 렌더링 도구 설치
O1에게 렌더링용 Python 스크립트(render.py) 요청
posts/ 폴더 안에 eng.md 형태로 포스트 작성
render.py 실행하여 HTML 변환 및 출력 폴더 생성

핵심 HTML 템플릿 (template.html)

HTML 구조는 심플하고 미니멀하며, {{ content }} 자리에 마크다운 렌더링 결과 삽입
CSS는 system-ui 기반 글꼴과 적응형 패딩, color-scheme 설정 등으로 가독성 확보

핵심 Python 렌더링 스크립트 (render.py)

markdown2를 활용하여 각 마크다운 포스트를 HTML로 변환
변환 시 <img> 경로를 /posts/{post_code}/로 자동 대체
HTML 제목은 마크다운의 # 헤더에서 추출
index.html은 greetings.md + 각 포스트의 제목 목록으로 구성
결과물은 ./blog/ 폴더에 .html로 저장됨

Read Entire Article