# Git & GitHub 셋업 가이드

코드를 한 번도 안 써본 사람을 위한 가이드입니다.

---

## 개념 정리

### Git이 뭔가요?

파일의 **변경 기록**을 저장하는 도구입니다.

```
작업 → 저장(커밋) → 또 작업 → 저장(커밋) → ...
```

언제든 이전 상태로 되돌릴 수 있습니다.
워드 문서의 "버전 기록"과 같은 개념입니다.

### GitHub가 뭔가요?

Git으로 저장한 파일을 **인터넷에 올리는 곳**입니다.

- 내 컴퓨터 → GitHub에 올리기 = **푸시(Push)**
- GitHub에 올리면 → 웹사이트로 공개 가능 = **GitHub Pages**

### 핵심 용어 4개만

| 용어 | 뜻 | 비유 |
|------|-----|------|
| **Repository (저장소)** | 프로젝트 폴더 | 작업 파일이 들어있는 폴더 |
| **Commit (커밋)** | 변경 내용 저장 | "여기까지 저장" 버튼 |
| **Push (푸시)** | GitHub에 올리기 | 클라우드에 업로드 |
| **Deploy (배포)** | 웹사이트로 공개 | 세상에 공개 |

### 흐름 한눈에

```
내 컴퓨터에서 작업
    ↓
커밋 (저장)
    ↓
푸시 (GitHub에 업로드)
    ↓
자동으로 웹사이트 업데이트
```

---

## 1단계: GitHub 계정 만들기

```
1. github.com 접속
2. Sign Up 클릭
3. 이메일 입력
4. 비밀번호 설정
5. Username 설정 ← 이게 내 도메인이 됩니다!
   예: username을 "jimin-design"으로 하면
   → jimin-design.github.io 가 내 주소
```

**Username 팁:**
- 짧고 기억하기 쉬운 이름
- 영문 소문자 + 숫자
- 본명, 닉네임, 브랜드명 등
- 나중에 바꿀 수 있지만, 주소도 바뀌니 처음에 잘 정하기

---

## 2단계: 저장소(Repository) 만들기

```
1. GitHub 로그인 후 우측 상단 "+" 클릭
2. "New repository" 선택
3. Repository name: username.github.io
   (예: jimin-design.github.io)
4. Public 선택
5. "Add a README file" 체크
6. Create repository 클릭
```

**이 이름(username.github.io)으로 만들면 자동으로 웹사이트가 됩니다.**

---

## 3단계: Antigravity에서 만든 사이트 연결하기

Antigravity에서 포트폴리오를 만들었다면, 아래 프롬프트로 배포를 요청하세요.

### 처음 연결할 때

```
이 프로젝트를 GitHub에 올려줘.

저장소 주소: https://github.com/내username/내username.github.io
브랜치: main
```

### 이미 연결된 후 업데이트할 때

```
지금까지 수정한 내용을 GitHub에 올려줘.
커밋 메시지는 "디자인 수정"으로 해줘.
```

---

## 자주 쓰는 요청 프롬프트

### 커밋 (저장)

```
지금까지 변경한 내용을 저장(커밋)해줘.
메시지는 "첫 번째 버전"으로.
```

### 푸시 (업로드)

```
커밋한 내용을 GitHub에 올려줘(푸시).
```

### 커밋 + 푸시 한번에

```
변경사항 저장하고 GitHub에 올려줘.
커밋 메시지: "프로필 사진 추가"
```

### 되돌리기

```
방금 수정한 거 취소하고 이전 상태로 돌려줘.
```

### 상태 확인

```
지금 변경된 파일이 뭐가 있는지 보여줘.
```

---

## 커밋 메시지 작성법

뭘 바꿨는지 짧게 적습니다.

**좋은 예:**
```
프로필 섹션 추가
색상 변경 - 파란색에서 노란색으로
모바일 레이아웃 수정
프로젝트 이미지 3장 추가
오타 수정
```

**안 좋은 예:**
```
수정함
업데이트
asdf
ㅇㅇ
```

---

## 배포 확인

푸시 후 1~2분 기다리면 웹사이트가 업데이트됩니다.

```
내 웹사이트 주소: https://내username.github.io
```

브라우저에서 이 주소를 열어 확인하세요.
변경이 안 보이면 **Ctrl+Shift+R** (강력 새로고침)을 누르세요.

---

## 문제가 생기면

| 상황 | 프롬프트 |
|------|---------|
| 충돌 발생 | "충돌 해결해줘" |
| 올라가지 않음 | "푸시 에러 해결해줘" |
| 사이트가 안 열림 | "GitHub Pages 설정 확인해줘" |
| 이전 버전으로 | "마지막 커밋 전으로 되돌려줘" |
| 뭐가 바뀌었는지 | "변경 내역 보여줘" |