아래 순서로 확인하면 대부분의 렌더링 문제를 빨리 찾을 수 있다.
1. 구조 확인
- 홈이 정상적으로 열리는가
- 소개/블로그/카테고리/태그/연락처가 서로 연결되는가
- 언어별 하위 경로가 유지되는가
2. 토큰 확인
- 색상, 배경, 테두리, 그림자가
theme-vars를 읽는가 - 폰트가 언어별로 바뀌는가
- 버튼과 CTA의 톤이 일관적인가
3. 문법 확인
- 헤딩, 표, 코드, 인용, 목록이 깨지지 않는가
- collapse 내부에서 markdownify가 유지되는가
- ltr/rtl 블록이 다른 요소를 밀어내지 않는가
4. 미디어 확인
- figure 캡션이 길어도 화면이 무너지지 않는가
- page bundle 리소스가 상대경로로 읽히는가
- 인라인 이미지가 baseline을 깨지 않는가
5. 배포 전 승인 기준
- 모든 링크가 실제 존재하는 경로로만 연결된다.
- 디자인 값은 콘텐츠가 아니라 중앙 토큰에서 관리된다.
- ko를 우선으로 검증해도 en/jp/cn 트리가 깨지지 않는다.
이 체크리스트는 기능 테스트가 아니라, “프런트엔드가 의도한 대로 읽히는가”를 보는 검증표다.
8. 公告专项检查
- base 文件与各语言覆盖文件是否分离
dismissMode = "session"、"persistent"、"hours"是否按预期工作- 带有
announcementProfile = "showcase"的页面是否能同时看到模态和内嵌卡片 - 图片、CTA、secondary CTA、caption 是否随语言文件切换
enabled = false的示例是否仍保留，便于随时启用
9. 发布前备注
- 设计仍然只由 theme-vars 控制
- UI 字符串仍然只从 theme i18n 读取
- 公告的运行时数据仍然只放在 announcement data 文件里
- 这份日志应该优先指向正确的文件路径