2026년 5월 2일 토요일

내 웹명함을 실제 인터넷 주소로 만드는 방법 (5분 컷)

 지금까지 만든 HTML 파일을 이제 인터넷 주소(URL)로 공개하는 단계다.

이걸 가능하게 해주는 게 바로 GitHubGitHub Pages 기능이다.



GitHub Pages란?

GitHub에 올린 파일을
무료로 웹사이트처럼 보여주는 기능

즉, HTML 파일 → 웹사이트로 변환


준비 조건

✔ GitHub에 코드 업로드 완료
.html 파일 존재 (예: wepnamecade1.html)


1단계: 파일 이름 확인 (중요)

메인 페이지 파일 이름은 반드시 : index.html

왜 중요하냐?

GitHub Pages는 기본적으로 index.html을 첫 화면으로 인식함

✔️ 해결 방법

파일 이름이 다르면 변경:

git mv wepnamecade1.html index.html
git commit -m "rename to index"
git push




2단계: GitHub Pages 활성화

  1. GitHub 저장소 접속 (긱허브 접속-로그인-왼쪽 내 저장소 링크 클릭)
  2. 상단 메뉴 → Settings 클릭
  3. 왼쪽 메뉴 → Pages 클릭



3단계: 배포 설정

아래처럼 설정

  • Source → Deploy from a branch
  • Branch → main
  • Folder → / (root)

Save 클릭 

(직접 수정하기전에 이미 저리 설정되있어서 save 비활성화 상태라면 이미 설정완료된거다)



 4단계: 배포 대기 (1~2분)

설정 후 잠깐 기다리면

이런 주소가 생성됨

https://아이디.github.io/저장소이름/

(생각보다...오래기다리셔야합니다.. 1~2분이라더니.. 전 10분넘게 기다림..😨)



 5단계: 접속 확인

위 주소 접속하면 내 웹명함이 인터넷에 공개됨🤞



전체 흐름 한 줄 요약

GitHub 업로드 → Pages 설정 → URL 생성 → 사이트 공개



자주 막히는 포인트

❗ 페이지가 안 뜰 때

index.html 이름 확인
✔ main 브랜치 선택 확인
✔ 1~2분 기다렸는지 확인


CSS/이미지 안 보일 때

경로 문제일 가능성 높음

예 : <img src="image.jpg">

✔ 파일이 GitHub에 같이 올라가 있어야 함


추가 꿀팁

주소를 더 깔끔하게 만들고 싶다면

  • 저장소 이름을
아이디.github.io

로 만들면 이렇게 됨

https://아이디.github.io

(저장소 이름 없이 바로 접속 가능)



 마무리

이 단계까지 오면 단순한 HTML 파일이 아니라 “실제 인터넷 서비스”를 만든 것

“개발 → 배포 → 공개” 전 과정 완료!



feat.주저리) 💬

저놈의 주소는 왤케 안뜨는지..10분 훨씬 넘게 기다려도 감가무소식이라..

ai한테 계속 물어봤습니다.. 대체 머가 문제야..ㅠㅠ..하고 ㅋ

제발 인내심 좀 가지고 기다리랍디다... ㅋ;;;


댓글 없음:

댓글 쓰기

PRD는 "절대문서"?.. 놉! — 앱 만들며 깨달은 것들

  지난 글에서 PRD가 뭔지, 어떻게 작성하는지 정리했었다.  이번엔 그 PRD를  실제로 "개발자 영어 학습 앱(Developer English)" 프로젝트에  써먹으면서 겪은 얘기를 해보려고 한다. 사실 이전까지 나는  기획 ...