이 문서는 stevehan310.github.io 저장소의 구조를 정리한 노트입니다.
ko_KR)stevemlblog)| 경로 | 설명 |
|---|---|
_posts/ |
실제 발행된 블로그 글 (Markdown). 2024-02 ~ 2026-08 작성 |
notebooks/ |
포스트에 대응하는 Jupyter 노트북. 아직 포스트로 변환되지 않은 것도 존재 |
_pages/ |
검색, 카테고리/태그 아카이브 등 정적 페이지 |
_data/navigation.yml |
사이트 메뉴 구조 정의 |
_data/ui-text.yml |
테마 UI 텍스트(로컬라이제이션) |
_includes/ |
테마 컴포넌트 조각 (헤더, 사이드바, 댓글, 검색 등) |
_layouts/, _sass/ |
테마 레이아웃 및 스타일 |
assets/ |
이미지, JS 등 정적 리소스. 포스트 이미지는 assets/images/<주제명>/ 하위에 저장 |
docs/ |
Minimal Mistakes 테마 자체의 데모 사이트 소스. _config.yml에서 Jekyll 빌드 시 제외됨 (테마 참고용, 실제 사이트 콘텐츠 아님) |
md/, _md/ |
(임시) 포스트로 아직 정리되지 않은 마크다운 초안을 두는 스테이징 폴더. 발행 후 삭제되므로 저장소에 상시 존재하지 않음 — 있다면 미발행 초안이 남아있다는 뜻 |
_posts/)notebooks/)_in_progress 파일명, 2024-04-06)두 가지 경로가 함께 쓰이고 있음:
notebooks/)으로 학습 내용을 정리 → 동일 날짜/제목으로 Jekyll 포스트(_posts/)로 변환하여 게시. 예: 2026-08-02 Neural Network 포스트.md/ 또는 _md/에 마크다운 초안을 먼저 작성 → 프론트매터(layout, title, author, tags, categories)를 추가해 _posts/YYYY-MM-DD-Title_With_Underscores.md로 옮기고 초안 폴더는 삭제 → 필요하면 이후에 notebooks/에 동일 stem의 노트북을 새로 만들어 실제 실행 결과(outputs)를 캡처해 추가. 예: 2026-08-10 Gradient Descent 포스트(노트북 없음), 2026-08-11 Adam Optimizer 포스트(포스트 발행 후 노트북 추가).공통 컨벤션:
_config.yml의 defaults에서 layout: single, toc: true, comments: true, search: true 등을 상속하므로, 포스트별 프론트매터는 title/author/tags/categories만 넣으면 됨.title과 중복되는 # 제목 H1 헤딩을 넣지 않는 것으로 컨벤션 정리됨.docs/)는 실제 사이트 빌드에서 제외되므로 편집 시 혼동 주의.Change.md 참고 (이 문서는 구조 요약, Change.md는 날짜별 변경 로그).