내보낸 포트폴리오를 인터넷에 무료로 공개하기

Portfolio Maker에서 받은 파일을 누구나 볼 수 있는 주소로 만드는 방법입니다. GitHub Pages를 씁니다 — 완전 무료이고, 서버를 빌리거나 관리할 필요가 없습니다.

준비물은 둘뿐입니다.
① Portfolio Maker에서 ZIP으로 내보낸 파일 (단일 HTML 말고 ZIP입니다)
② 이메일 주소 하나 (GitHub 가입용)

다 하는 데 10~15분 걸립니다. 중간에 막히면 그 단계만 다시 읽어 보세요.

전체 그림

먼저 무엇을 하는지 알고 시작하면 훨씬 쉽습니다. 세 단계뿐입니다.

파일을 GitHub에 맡기면 GitHub이 대신 인터넷에 보여 줍니다.

GitHub은 개발자들이 파일을 보관하는 곳입니다. 여기서는 무료 호스팅으로만 씁니다.

github.com/signup 접속
이메일 · 비밀번호 · 아이디를 정합니다
아이디는 신중하게 정하세요. 이 아이디가 주소에 그대로 들어갑니다. hong-gildong으로 정하면 주소가 hong-gildong.github.io/...가 됩니다. 나중에 바꿀 수는 있지만 이미 알려 준 주소가 끊깁니다.
메일로 온 인증 번호를 입력하면 끝입니다

저장소(repository)는 파일을 담을 폴더입니다. 포트폴리오 하나에 저장소 하나면 됩니다.

로그인한 상태에서 오른쪽 위 + 를 누르고 New repository
Repository name에 이름을 적습니다 (예: portfolio)
이름도 주소에 들어갑니다. portfolio로 하면 아이디.github.io/portfolio/가 됩니다. 영어 소문자와 -만 쓰세요 — 한글이나 띄어쓰기는 주소가 깨집니다.
Public을 고릅니다
Private으로 하면 무료로는 공개되지 않습니다. 남에게 보여줄 포트폴리오이니 Public이 맞습니다. Public은 파일이 공개된다는 뜻이지 아무나 고칠 수 있다는 뜻이 아닙니다.
나머지는 건드리지 말고 Create repository
“Add a README file”에 체크하지 마세요. 체크하면 저장소가 비어 있지 않게 되어, 다음 단계의 업로드 안내 문구가 안 나옵니다.

받은 ZIP의 압축을 풀고, 그 안의 내용물만 올립니다. 폴더째 올리면 안 됩니다.

압축을 푼 폴더 안으로 들어가서 그 안의 것들을 전부 선택해 올립니다.

여기까지 잘 됐는지 확인 저장소 첫 화면 파일 목록에 index.html과 assets가 바로 보이면 성공입니다. 폴더 이름이 하나 보이고 그걸 눌러야 index.html이 나온다면 잘못 올린 것입니다 — 그 폴더를 지우고 2단계를 다시 하세요.

파일을 올려도 아직 아무도 못 봅니다. GitHub에게 “이걸 웹사이트로 보여 줘”라고 알려 줘야 합니다.

저장소 위쪽 Settings → 왼쪽 목록에서 Pages.

바로 안 열려도 정상입니다. 처음 켤 때는 준비에 몇 분 걸립니다. 404가 뜨면 1~2분 뒤 새로고침해 보세요. 5분이 지나도 그대로면 2단계의 확인 항목부터 다시 보세요.

증상	원인과 해결
404 페이지가 뜬다	대개 index.html이 맨 위에 없어서입니다. 저장소 첫 화면에 index.html이 바로 보이는지 확인하세요. 아니면 켠 지 2분이 안 됐을 수 있습니다.
글자만 나오고 디자인이 없다	`assets` 폴더를 같이 안 올렸을 때입니다. 폴더 안의 것을 전부 올려야 합니다.
3D 모델이 안 보인다	ZIP이 아니라 단일 HTML로 내보냈을 수 있습니다. 3D는 ZIP에만 들어갑니다. 내보내기에서 ZIP 내려받기로 다시 받으세요.
내 컴퓨터에서 더블클릭하면 3D가 안 보인다	이건 고장이 아닙니다. 브라우저가 내 컴퓨터의 파일에서는 3D를 막습니다. GitHub Pages에 올리면 정상입니다. 미리 보려면 폴더에서 `python -m http.server`를 실행하세요.
고쳤는데 예전 화면이 나온다	브라우저가 기억해 둔 것입니다. `Ctrl`+`Shift`+`R`로 강력 새로고침하세요.

아이디.github.io/portfolio 대신 내이름.com 같은 주소를 쓰고 싶다면 → 내 도메인 연결하기