아래 순서로 확인하면 대부분의 렌더링 문제를 빨리 찾을 수 있다.

1. 구조 확인

  • 홈이 정상적으로 열리는가
  • 소개/블로그/카테고리/태그/연락처가 서로 연결되는가
  • 언어별 하위 경로가 유지되는가

2. 토큰 확인

  • 색상, 배경, 테두리, 그림자가 theme-vars를 읽는가
  • 폰트가 언어별로 바뀌는가
  • 버튼과 CTA의 톤이 일관적인가

3. 문법 확인

  • 헤딩, 표, 코드, 인용, 목록이 깨지지 않는가
  • collapse 내부에서 markdownify가 유지되는가
  • ltr/rtl 블록이 다른 요소를 밀어내지 않는가

4. 미디어 확인

  • figure 캡션이 길어도 화면이 무너지지 않는가
  • page bundle 리소스가 상대경로로 읽히는가
  • 인라인 이미지가 baseline을 깨지 않는가

5. 배포 전 승인 기준

  • 모든 링크가 실제 존재하는 경로로만 연결된다.
  • 디자인 값은 콘텐츠가 아니라 중앙 토큰에서 관리된다.
  • ko를 우선으로 검증해도 en/jp/cn 트리가 깨지지 않는다.

이 체크리스트는 기능 테스트가 아니라, “프런트엔드가 의도한 대로 읽히는가”를 보는 검증표다.

8. Announcement-specific checks

  • Base data and language overrides are split cleanly
  • dismissMode = "session", "persistent", and "hours" behave as expected
  • The announcementProfile = "showcase" front matter value renders the modal and inline card examples on the showcase page
  • Images, CTAs, secondary CTAs, and captions swap with the language file
  • enabled = false samples remain available for quick activation

9. Pre-release notes

  • Theme styling still lives only in theme-vars
  • UI strings still come only from theme i18n
  • Operational values still live in the announcement data files
  • This log should point maintainers to the correct files first