GitHub에 올리기

GitHub는 작업 파일을 시간순으로 저장해 두는 곳입니다. 오늘은 강사 저장소를 내 계정으로 복사(포크)해서 그 안에서 작업하고, 고칠 때마다 기록을 남기는 것까지 합니다. 포크한 뒤로는 내 저장소이므로, 개발은 각자 자기 포크에서 합니다.

용어 네 개만

• 저장소(repository) — 프로젝트 폴더 하나.
• 포크(fork) — 남의 저장소를 통째로 내 계정에 복사하기. 복사한 뒤로는 내 것이라 마음대로 고쳐도 됩니다.
• 클론(clone) — 내 저장소를 내 컴퓨터로 내려받기.
• 커밋(commit) — "여기까지 저장" 도장. 메시지 한 줄이 붙습니다.
• 푸시(push) — 내 컴퓨터의 커밋을 GitHub로 올리기.

1. 포크하기

1. github.com/joonhyungbae/opencircuit↗ 를 엽니다.
2. 오른쪽 위 Fork 버튼.
3. Repository name 을 자기 것으로 바꿉니다 — 예: sohee-opencircuit, tide-machine. 영문·숫자·하이픈으로 짓는 게 안전합니다.
4. Create fork.

https://github.com/내아이디/내가정한이름 이 생겼으면 끝입니다. 이제 이 저장소는 내 것입니다.

2. 내 컴퓨터로 내려받기 (clone)

Cursor 시작 화면의 Clone Repo, 또는 터미널(Ctrl/⌘+`)에서:

cd ~/Documents
git clone https://github.com/내아이디/내가정한이름.git

Windows 문서 폴더는 cd ~/Documents 대신 파일 탐색기에서 문서 폴더를 연 뒤 Cursor로 그 폴더를 열어도 됩니다.

내려받아진 폴더를 Cursor로 엽니다. 오늘 작업은 전부 이 폴더 안에서 합니다.

3. 이름 알려주기 (처음 한 번)

커밋에는 누가 했는지가 붙습니다. 터미널에서 한 번만:

git config --global user.name "내 이름"
git config --global user.email "GitHub에 쓴 이메일"

4. 내 작업 파일 만들기

Cursor 채팅(Ctrl/⌘+L)에 시켜 봅니다. 파일은 폴더 맨 위(루트) 에 만들게 하세요 — 그래야 나중에 Pages 주소가 바로 열립니다.

폴더 맨 위에 index.html 을 만들어 줘. 내 이름과 오늘 만들 것 한 줄이 적힌 페이지야.

5. 커밋하고 올리기

Cursor 왼쪽 Source Control(가지 모양) 아이콘 → 메시지 한 줄 쓰고 ✓ → Sync. 터미널이 싫으면 이것만으로 끝납니다.

터미널로 하려면:

git add .
git commit -m "무엇을 바꿨는지 한 줄"
git push

GitHub 페이지를 새로고침해서 방금 만든 index.html 이 보이면 성공입니다. 최소 목표(push 1회)를 여기서 달성한 것입니다.

헷갈리면 — 폴더 세 개 구분

인터넷에 공개하기 (선택)

내 저장소 Settings → Pages → Branch: main / (root) → Save. 1~2분 뒤 https://내아이디.github.io/내가정한이름/ 에서 아까 만든 페이지가 열립니다. 다음 회차부터 만든 것을 서로 보여 줄 때 이 주소를 씁니다.

원본이 업데이트되면 (이후 회차)

강사 저장소에 도구가 추가되면 내 포크에는 자동으로 오지 않습니다. 내 저장소 위쪽의 Sync fork → Update branch 를 누르면 따라옵니다. 오늘은 하지 않아도 됩니다.