이 저장소는 Minimal Mistakes 테마를 기반으로 한 Jekyll 사이트입니다. 사이트 콘텐츠는 날짜별 소식, 프로그램, 식단 게시물을 담는 _posts/와 상시 제공 페이지를 담는 _pages/에 있습니다. 공통 Liquid 마크업은 _includes/, 페이지 템플릿은 _layouts/에서 관리합니다. 내비게이션과 번역된 UI 문구는 _data/, 사이트 전역 설정은 _config.yml에서 수정합니다. 스타일은 _sass/, JavaScript 소스와 이미지는 각각 assets/js/, assets/images/에 저장합니다. docs/와 test/는 운영 사이트가 아니라 원본 테마의 문서 및 테스트용 콘텐츠입니다.
bundle install: Gemfile에 정의된 Jekyll, GitHub Pages 및 Ruby 플러그인을 설치합니다.npm install: JavaScript 번들을 다시 만드는 데 필요한 UglifyJS를 설치합니다.bundle exec jekyll serve --force_polling --livereload: 라이브 리로드를 적용해 사이트를 로컬에서 실행합니다. ./serve.sh로도 실행할 수 있습니다.bundle exec jekyll build --trace: 운영 사이트를 _site/에 생성하고 Liquid, YAML 또는 플러그인 오류를 자세히 출력합니다.bundle exec rake preview: 레이아웃이나 테마 코드를 수정할 때 test/의 테마 테스트 사이트를 실행합니다.bundle exec rake js: JavaScript 소스를 변경한 뒤 assets/js/main.min.js와 소스 맵을 다시 생성합니다..editorconfig 설정을 따릅니다. UTF-8과 LF 줄바꿈을 사용하고, 들여쓰기는 공백 2칸으로 하며, 불필요한 후행 공백은 제거합니다. Markdown에서 강제 줄바꿈을 위한 후행 공백은 유지합니다. 인접한 템플릿의 Liquid 작성 방식을 따르고 YAML 프런트 매터의 문법과 들여쓰기를 일관되게 유지합니다. 게시물 파일명은 YYYY-MM-DD-설명형-제목.md 형식을 사용하며 한글 제목도 허용됩니다. 날짜별 이미지는 assets/images/ 아래에 연도와 행사 기준의 명확한 디렉터리로 정리하고 루트 상대 경로로 참조합니다.
별도의 단위 테스트나 명시된 커버리지 기준은 없습니다. bundle exec jekyll build --trace가 오류 없이 완료되는 것을 필수 검증으로 간주합니다. 콘텐츠 변경 사항은 로컬에서 미리 보고 내비게이션, 이미지 경로, 반응형 레이아웃, 생성된 링크를 확인합니다. 레이아웃, Sass 또는 include 파일을 변경했다면 대표 페이지를 직접 점검하고 test/ 테스트 사이트도 실행합니다.
최근 커밋은 2026년 1월 프로그램 안내처럼 하나의 콘텐츠 변경을 설명하는 짧은 한글 제목을 사용합니다. 이 형식을 따르고 서로 관련 없는 변경은 분리합니다. 의미 있는 이름의 브랜치를 master에서 생성합니다. 풀 리퀘스트에는 변경 유형과 결과 요약, 관련 이슈 링크를 포함하고, 화면이 달라지는 경우 변경 전후 스크린샷을 첨부합니다. 리뷰를 요청하기 전에 로컬 빌드가 성공하는지 확인합니다.