🚀 가이드북 마스터를 위한 고급 서식 레이아웃 테스트#

이 문서는 Hugo Book 테마가 지원하는 특수 레이아웃과 서식들이 다국어 파이프라인에서 깨지지 않고 정갈하게 유지되는지 확인하는 최종 스펙 점검 원고입니다.

💡 1. 가이드북의 핵심, 알림 박스 (Hint / Callout)#

📌 중요 안내 사항 가이드북을 읽을 때 유저가 꼭 봐야 하는 핵심 팁은 이렇게 인용구(>)와 이모지를 조합하여 시각적 주목도를 높일 수 있습니다.

• 한·영 번역 포인트: 이모지(📌)와 볼드체(**중요 안내 사항**) 서식이 들뜨지 않고 영문 버전에서도 완벽하게 박스 레이아웃을 유지해야 합니다.

🔗 2. 하이퍼링크와 인라인 코드 결합 디펜스#

코드 블록과 링크가 한 문장 안에 복잡하게 얽혀있을 때의 안전성 테스트입니다.

• 시스템 환경 설정을 초기화하려면 rm -rf .hugo_build_lock 명령어를 실행하거나, 클라우드플레어 공식 문서를 참고하여 엣지 캐시를 강제로 비워주세요.
• 번역 봇의 미션: 영문 버전에서 링크 주소와 백틱(`) 안의 리터럴 코드는 단 한 글자도 오염되지 않고 그대로 유지되어야 합니다.

🛠️ 3. 2단 리스트 중첩 (Nested List) 구조 스캐닝#

마크다운의 단골 억까 구간인 ‘탭(Tab) 공백 기반 중첩 리스트’가 영문 파일(.en.md)로 복사될 때 정렬이 무너지지 않는지 검증합니다.

1. 1단계 공정: 콘텐츠 작성
   • 작성자는 오직 한국어로만 타이핑합니다.
   • 이미지는 static/images/ 폴더 경로를 활용합니다.
2. 2단계 공정: 인공지능 번역 및 배포
   • 깃허브 액션이 깨어나서 문맥을 분석합니다.
   • Cloudflare Pages가 최종 렌더링을 마칩니다.

🎯 4. 체크리스트 (Task Lists) 가동성 점검#

가이드북에서 체크리스트 기능을 쓸 때 사용하는 특수 서식입니다.

• 한글 원문 Private 깃허브에 안착 완료
• Cloudflare Workers 인증 게이트웨이 정상 가동
• 글로벌 에지 캐시 최적화 규칙 적용 (진행 예정)