Skip to content

Commit c15a200

Browse files
committed
feat: CLAUDE.md 파일을 추가하다
- 지금 상태를 저장해놓음.
1 parent 4ca2a11 commit c15a200

File tree

1 file changed

+60
-0
lines changed

1 file changed

+60
-0
lines changed

CLAUDE.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# CLAUDE.md
2+
3+
This file provides guidance to Claude Code (claude.ai/code) when working with
4+
code in this repository.
5+
6+
## Project Overview
7+
8+
This is a Korean personal blog powered by Pelican (static site generator) with a
9+
custom CLI tool for content management. The blog uses a custom "clean" theme and
10+
supports both Markdown and reStructuredText content.
11+
12+
## Common Commands
13+
14+
### Blog Management
15+
16+
- `uv run cli post <TITLE>` - Create a new blog post with proper metadata
17+
template
18+
- `uv run cli preview` - Start development server with auto-reload (
19+
`pelican --autoreload --listen`)
20+
- `uv run cli build` - Build site for production using publishconf.py
21+
- `uv run cli clean` - Clean output directory and cache files
22+
23+
### Package Management
24+
25+
- `uv sync` - Install dependencies from uv.lock
26+
- `uv add <package>` - Add new dependency
27+
28+
## Architecture
29+
30+
### Content Structure
31+
32+
- Blog posts are stored in `content/blog/YYYY/` directories
33+
- Posts use Pelican metadata format with Title, Date, Category, Tags, Slug,
34+
Summary
35+
- Images are organized in `content/img/YYYY/` matching post dates
36+
- Content supports both Markdown (.md) and reStructuredText (.rst)
37+
38+
### CLI Tool (`cli/main.py`)
39+
40+
- Built with Cleo framework for command-line interface
41+
- PostCmd: Generates post templates with Korean slug support
42+
- PreviewCmd: Wrapper for Pelican development server
43+
- BuildCmd: Production build using publishconf.py settings
44+
- CleanCmd: Cleanup utility for output and cache directories
45+
46+
### Configuration
47+
48+
- `pelicanconf.py`: Development configuration with relative URLs
49+
- `publishconf.py`: Production configuration with absolute URLs, analytics, and
50+
feeds
51+
- Uses custom "clean" theme located in `clean/` directory
52+
- Markdown extensions include mermaidjs, toc, codehilite, and more
53+
54+
### Key Features
55+
56+
- Korean language support with proper timezone (Asia/Seoul)
57+
- Mermaid.js integration for diagrams
58+
- Multiple comment systems (Utterances, Giscus)
59+
- Google Analytics and AdSense integration in production
60+
- Buy Me a Coffee integration

0 commit comments

Comments
 (0)