GitHub Pages 배포

baseURL 확인 #

GitHub Pages에 배포할 때 가장 먼저 확인할 값은 baseURL입니다.

baseURL: "https://username.github.io/repository/"

사용자 페이지 저장소라면 보통 아래 형식입니다.

baseURL: "https://username.github.io/"

Pages 설정 #

GitHub 저장소의 Settings > Pages에서 배포 방식을 선택합니다.

GitHub Actions를 쓰면 Hugo 버전과 빌드 옵션을 직접 관리할 수 있어 편합니다.

빌드 명령 #

로컬에서 배포 전 확인할 때는 아래 명령을 실행해봅니다.

hugo --minify

오류 없이 public/이 생성되면 기본 빌드는 성공한 것입니다.

배포 전 점검 #

• baseURL이 실제 주소와 일치하는가?
• theme: "seotax"가 설정되어 있는가?
• content 또는 content.ko에 search/_index.md가 있는가?
• 댓글을 켰다면 giscus 또는 Disqus 값이 채워져 있는가?
• 서비스 워커를 켰다면 캐시 영향까지 확인했는가?