byminseok.com

CLAUDE.md — byminseok.com

CLAUDE.md — byminseok.com

코드 작성 규칙

  • SCSS 파일에서는 영문 주석만 사용 (Jekyll sass-converter 1.5.2가 non-ASCII 문자를 처리 못함)
  • SCSS에서 유니코드 특수문자는 CSS escape 사용 (예: ● → \25CF, ✓ → \2713)

Jekyll 블로그 (byminseok.com)

  • 빌드: github-pages gem (Jekyll 3.10 + Liquid 4.0) — Ruby 3.3 필요
  • 로컬 서버 (macOS): cd byminseok.com && PATH="/opt/homebrew/opt/ruby@3.3/bin:$PATH" bundle exec jekyll serve
  • 로컬 서버 (Windows): cd byminseok.com && bundle exec jekyll serve (RubyInstaller 사용, PATH 별도 설정 불필요)
  • 포스트 본문에서 <한글텍스트> 꺾쇠괄호는 HTML 태그로 해석됨 → ⟨⟩ 유니코드 꺾쇠로 변환 필수
  • 페이지 구조: writings (일반글, exclude_tags), techphil (기술철학, filter_tags), devlog (개발기록, filter_tags)
  • 스프레드 레이아웃: 데스크탑 960px+ 에서 왼쪽 목록 + 오른쪽 본문 2단 구조

블로그 파일 구조

  • 태그 라우팅: _data/categories.yml — 카테고리별 태그 규칙 (post.html, home.html이 참조)
  • JS: assets/js/ — spread.js (Spread.init 패턴), tag-filter.js, typing-intro.js
  • SCSS: _sass/_variables.scss (색상·폭 변수), _layout.scss (body/header/footer), _post.scss (포스트/목록/태그필터), _spread.scss (스프레드 패널/토글/확대)
  • 색상 변수: --color-accent (테라코타), --color-accent-hover, --color-accent-text — 하드코딩 금지, 변수 사용
  • 스프레드 폭 변수: --spread-list-width, --spread-body-width — calc() 직접 쓰지 말고 변수 참조
  • 새 카테고리 추가 시 _data/categories.yml만 수정하면 됨 (Liquid 조건문 수정 불필요)

블로그 이미지 처리

포스트에 이미지가 있을 때 아래 순서로 처리:

  1. assets/img/YYYY-MM-DD-슬러그/ 폴더 생성 (포스트 파일명 기준)
  2. 이미지를 해당 폴더로 이동
  3. 이미지 최적화 (가로 1200px 초과 시 리사이즈 + JPEG 80% 변환)
    • macOS: sips 사용
    • Windows: magick 사용 (ImageMagick)
  4. 포스트 내 옵시디언 문법 ![[파일명]] → 표준 마크다운 ![alt](/assets/img/경로/파일명.jpg) 변환
  5. <한글> 꺾쇠괄호 → ⟨한글⟩ 유니코드 변환 확인
  6. _posts/에 남은 이미지 파일 삭제
  7. Jekyll 빌드 확인

글쓰기 & 문서화

  • 블로그 포스트 작성 시 콜론(:) 사용 금지. 한국어 문장에서 콜론은 부자연스럽고 AI 생성 티가 남. 마침표(.)로 끊거나 문장을 자연스럽게 이어 쓸 것
  • 자연스러운 줄글 선호. 과도한 불렛 포인트 지양
  • 마크다운 기반 기록을 좋아함. 작업 과정이나 결과를 .md로 남기기 쉽게 구성
  • 옵시디언 사용 중 — 문서 산출물은 옵시디언 호환 마크다운으로
  • 마크다운 노트 저장 위치: workspace/byminseok.com/_posts/ (옵시디언에서도 접근 가능)
  • 파일명 규칙: YYYY-MM-DD-제목.md (예: 2026-02-14-workspace-setup.md)