Hugo 사이트 공개 전 QA 체크리스트

Hugo 사이트는 빠르게 배포할 수 있지만, 공개 전 확인을 건너뛰면 sitemap 누락, 깨진 내부 링크, 모바일 가로 스크롤, 비공개 문자열 노출 같은 문제가 남을 수 있습니다.

바로 실행

• 로컬에서 Hugo 빌드를 실행합니다.
• 주요 페이지의 title과 description을 확인합니다.
• 내부 링크와 sitemap, robots, 404 페이지를 확인합니다.
• 공개 HTML에 비공개 이메일, 로컬 경로, 토큰, 내부 repo 정보가 없는지 검색합니다.

체크리스트

• hugo --gc --minify 빌드가 통과하는지 확인
• 새 페이지가 sitemap에 포함되는지 확인
• /docs나 내부 운영 문서가 sitemap에 들어가지 않았는지 확인
• 주요 내부 링크가 실제 콘텐츠로 연결되는지 확인
• 404 페이지가 한국어 안내와 주요 링크를 제공하는지 확인
• 390px과 430px 폭에서 가로 스크롤이 없는지 확인
• 공개 HTML에 private string이 없는지 확인

확인 명령어

hugo --gc --minify
rg -n "TODO|SECRET|API_KEY|LOCAL_PATH" content layouts data assets
rg -n "old-private@example.com" public

프로젝트마다 금지 문자열은 다를 수 있으므로 실제 운영 환경에 맞게 검색어를 바꾸세요.

주의할 점

• 공개 전 QA는 배포 후 smoke test를 대신하지 않습니다.
• 테스트 데이터나 예시 이메일이 실제 개인 정보처럼 보이지 않도록 확인하세요.
• 검색 엔진 설정, DNS, redirect 변경은 별도 승인과 검토가 필요한 작업으로 분리하세요.

관련 GoAll 가이드/도구

• Cloudflare Pages 배포 후 확인 체크리스트
• Google Search Console 새 URL 제출 체크리스트
• Naver Search Advisor 웹페이지 수집 체크리스트
• 생활 도구
• Hugo 공식 문서