이 글은 블로그 UI를 확인하기 위한 샘플 글입니다. 실제 배포 이력이 아닌 일반적인 절차를 정리했습니다.

정적 사이트는 빌드가 성공하면 결과물이 그대로 배포됩니다. 그만큼 빌드 전에 확인할 수 있는 문제는 최대한 자동 검사로 잡아 두는 편이 안전합니다.

자동 검사

가장 먼저 코드 스타일과 정적 분석을 실행합니다. 검사 순서를 고정해 두면 실패 원인을 찾기 쉽습니다.

pnpm format:check
pnpm lint
pnpm build

타입 검사를 빌드에 포함하면 콘텐츠 스키마와 맞지 않는 값이 배포 전에 드러납니다.

결과물 확인

링크와 경로

빌드된 페이지의 내부 링크가 실제 파일과 일치하는지 확인합니다. 마지막 슬래시 규칙을 정했다면 모든 링크가 같은 규칙을 따르는지도 살펴봅니다.

메타데이터

항목 확인 내용
title 페이지마다 고유한지
description 비어 있거나 중복되지 않는지
canonical URL 배포 도메인 기준의 절대 URL인지
사이트맵·RSS 공개할 페이지만 포함하는지

공개하지 않을 콘텐츠

초안이나 미리보기용 샘플처럼 공개하지 않을 콘텐츠는 목록에서만 숨기는 것으로 충분하지 않습니다. 상세 페이지, RSS, 사이트맵 생성 단계에서도 함께 제외되는지 확인해야 합니다.

조회 함수 한 곳에서 공개 여부를 결정하면, 새 페이지를 추가할 때도 같은 규칙이 자연스럽게 적용됩니다.