base 받기와 설치

이 단계의 목표는 단순합니다. blog-studio를 본인 컴퓨터로 받고, 발행 스크립트가 쓰는 Python 패키지를 설치하는 것까지입니다. 보통 10분 안에 끝납니다.

1) base 받기

라이선스를 받아 GitHub Template로 접근할 수 있다면 GitHub에서 “Use this template”으로 본인 저장소를 만든 다음 clone 합니다. 그게 아니라면 git clone으로 직접 받습니다.

cd ~/projects
git clone https://github.com/ddakit/blog-studio.git my-blog
cd my-blog

~/projects 폴더가 없으면 mkdir -p ~/projects를 먼저 실행합니다. my-blog는 본인이 원하는 이름으로 바꿔도 됩니다.

정상 화면: “Cloning into ‘my-blog’…”로 시작하는 줄이 보이고, 잠시 후 프롬프트가 돌아오면 정상입니다.

막힌 화면:

• “command not found: git” → git이 안 깔린 상태입니다. prerequisites의 git 항목으로 돌아갑니다.
• “Permission denied” 또는 인증 요청 → private 저장소라면 GitHub 로그인이 필요합니다. Template로 만든 본인 저장소 URL을 쓰는 편이 깔끔합니다.

2) 받은 폴더 안으로 들어가기

cd my-blog
ls

AI_AUTOMATION.md, CLAUDE.md, scripts/, .claude/ 같은 이름이 보이면 제대로 받은 것입니다.

3) 발행 스크립트 의존성 설치

Blogger 발행 스크립트가 쓰는 Python 패키지를 설치합니다.

pip install -r scripts/requirements.txt

또는 pip이 Python 2를 가리키는 환경이면 pip3을 씁니다.

정상 화면: 패키지들이 다운로드되고 마지막에 “Successfully installed …” 같은 줄이 뜨면 정상입니다.

막힌 화면:

• “command not found: pip” → pip3 install -r scripts/requirements.txt로 다시 시도합니다. 그래도 안 되면 prerequisites의 Python 항목에서 python3-pip이 깔렸는지 확인합니다.
• 권한 에러가 뜨면 pip install --user -r scripts/requirements.txt로 사용자 영역에 설치합니다.

4) git 이력 분리는 first-run이 안내

base를 git clone으로 받으면 base의 커밋 이력이 그대로 따라옵니다. 본인 작업 커밋이 그 위에 쌓이기 전에 이력을 끊어 두는 편이 깔끔한데, 이 자리는 다음 단계의 /start가 자동으로 감지해 한 번 물어봅니다. 지금 손으로 할 필요는 없습니다.

다음

받기와 설치가 끝났으면 first-run으로 갑니다. /start로 환경을 검증하고 블로그 정체성을 잡습니다.