ChocoBreeze Blog

Astro 기반 개인 블로그 저장소입니다.
투자, 반도체, 컴퓨터공학, 프로그래밍, 문제 해결, 리포트형 글을 Markdown 중심으로 관리합니다.

Tech Stack

• Astro 6
• Markdown / MDX
• Astro Content Collections
• remark-math + rehype-katex
• Sitemap / RSS
• GitHub Pages via GitHub Actions

Run

npm install
npm run dev

기본 개발 서버는 http://localhost:4321에서 실행됩니다.

Scripts

• npm run dev: 개발 서버 실행
• npm run build: 프로덕션 빌드
• npm run preview: 빌드 결과 미리보기
• npm run astro: Astro CLI 실행
• npm run astro -- check: Astro 검사

Project Structure

.
├─ public/
├─ src/
│  ├─ components/
│  ├─ content/
│  │  └─ blog/
│  ├─ data/
│  ├─ layouts/
│  ├─ pages/
│  └─ styles/
├─ astro.config.mjs
├─ agent.md
├─ package.json
└─ README.md

Main Routes

• /: 홈
• /blog/[...slug]: 개별 글
• /search: 글 검색
• /etf
• /semiconductor
• /cs
• /programming
• /problem-solving
• /reports
• /market-brief

Content Rules

모든 글은 src/content/blog/**/*.{md,mdx} 에서 로드됩니다.

대표 frontmatter 필드:

• title: 필수
• slug: 선택, URL 안정성을 위해 권장
• description: 선택
• pubDate: 권장 발행일 필드
• updatedDate: 선택
• categories: 선택
• tags: 선택
• pinned: 선택
• order: 선택

콘텐츠 스키마는 src/content.config.ts에서 관리합니다.

Categories

현재 카테고리 정의는 src/data/blogCategories.ts에 있습니다.

• ETF
• Semiconductor
• Computer Science
• Programming
• Problem_Solving
• Reports
• Market Brief

카테고리 페이지에 노출되어야 하는 글은 categories 값이 위 규칙과 맞아야 합니다.

Writing Notes

• 새 글은 주제에 맞는 하위 폴더에 추가합니다.
• 파일명이 한글, 공백, 특수문자를 포함하면 slug를 명시하는 편이 안전합니다.
• 기존 폴더 구조는 이미 콘텐츠 정리 방식과 연결되어 있으므로 임의 재구성은 피하는 것이 좋습니다.
• 수식이 필요한 글은 Markdown 안에서 KaTeX 문법을 사용할 수 있습니다.

Deployment

GitHub Pages 배포는 .github/workflows/deploy.yml에서 관리합니다.

• withastro/action@v5
• node-version: 22.12.0

Astro 6 기준으로 배포 환경도 Node 22.12.0+를 유지하는 것이 좋습니다.

Verification

의미 있는 레이아웃 변경이나 글 추가 후에는 아래 순서로 확인하는 것을 권장합니다.

npm run astro -- check
npm run build

Agent Guide

자동화 에이전트나 협업용 작업 규칙은 agent.md에 정리되어 있습니다.
이 문서는 프로젝트 전용 운영 규칙용이며, 개인 전용 메모가 아니라면 보통 .gitignore에 넣지 않고 저장소에 포함합니다.