이전

CLAUDE.md

CLAUDE.md

이 파일은 Claude Code가 프로젝트를 이해하는 데 사용하는 컨텍스트 문서입니다.

프로젝트 개요

Jekyll 기반 개인 기술 블로그 (GitHub Pages)

기술 스택

디렉토리 구조

├── _posts/          # 블로그 포스트 (Markdown)
├── _layouts/        # 페이지 레이아웃 템플릿
│   ├── default.html
│   ├── home.html
│   └── post.html
├── _includes/       # 재사용 컴포넌트
│   ├── head.html         # <head> 태그, 폰트/CSS 로드
│   ├── post_list.html    # 포스트 목록 컴포넌트
│   ├── toc.html          # 목차 (Table of Contents)
│   └── related-posts.html # 관련 글 추천
├── _sass/           # SASS 스타일시트
│   └── no-style-please.scss  # 기본 테마 변수 및 스타일
├── _data/           # 데이터 파일
│   └── menu.yml
├── assets/
│   ├── css/main.scss     # 메인 스타일시트 (커스텀 확장)
│   └── js/
│       ├── code-copy.js  # 코드 복사 버튼
│       └── search.js     # 검색 기능
├── _config.yml      # Jekyll 설정
└── Gemfile          # Ruby 의존성

포스트 작성 규칙

Front Matter 형식

---
layout: post
title: 제목
tags: [tag1, tag2]
---

카테고리 (선택적)

태그 체계 (정형화됨)

| 태그 | 용도 | |—–|—–| | java | Java 언어 | | spring | Spring 프레임워크 | | jpa | JPA/ORM | | design-pattern | 디자인패턴 | | database | DB 일반 | | javascript | JS/프론트엔드 | | performance | 성능 최적화 | | aws | AWS 서비스 | | architecture | 설계/클린코드 | | testing | 테스트 | | git | 버전관리 | | devops | 인프라 | | essay | 비기술 글 |

로컬 개발

Docker로 실행 (권장)

docker run --rm -v "$(pwd)":/site -p 4000:4000 bretfisher/jekyll-serve

Ruby로 실행

bundle install
bundle exec jekyll serve

접속: http://localhost:4000

블로그 기능

포스트 기능

검색 기능

네비게이션

스타일 가이드

CSS 변수 (no-style-please.scss)

--fg: black;        // 텍스트 색상 (다크모드: #e0e0e0)
--bg: white;        // 배경색 (다크모드: #1a1a1a)
--link: #007acc;    // 링크 색상 (다크모드: #6db3f2)
--border: black;    // 테두리 색상 (다크모드: #555)

주요 스타일 클래스 (main.scss)

반응형 브레이크포인트

포스트 작성 시 주의사항

마크다운 테이블

테이블 구분선 너비를 콘텐츠에 맞게 조정:

| 컬럼1 | 컬럼2 | 컬럼3 |
|-------|-------|-------|
| 내용  | 내용  | 내용  |

헤딩 구조 (TOC용)

주의사항