이 문서는 다음 유지보수자를 위한 인수인계 기록이다.

이번 패스의 핵심은 content-only 업그레이드를 통해, 검증용 포스트가 프런트엔드에서 충분히 많은 기능을 드러내도록 정리하는 것이다.
디자인의 중심은 여전히 themes/(0000-0000-0000-0001)/assets/css/core/theme-vars.css 와 themes/(0000-0000-0000-0001)/assets/css/core/theme-vars/ 다.
이 문서는 그 중앙 제어 파일들을 바꾸지 않고도, 콘텐츠만으로 무엇을 더 검증하게 되었는지를 남긴다.

이번 패스의 핵심 수정

1) 검증 랩 콘텐츠를 실제 렌더링 중심으로 확장

  • 00-full-coverage.md 를 한 페이지 요약이 아니라 실전 검사 페이지로 강화했다.
  • 01-foundation/ 은 토큰의 존재만 설명하지 않고 실제 표면에서의 결과를 보여 준다.
  • 02-components/ 는 CTA, 카드, figure, inline image, input 상태를 전부 표본으로 넣었다.
  • 03-rendering/ 은 기본 Markdown 문법과 숏코드 조합, 경계 사례를 분리했다.
  • 04-architecture/ 는 page bundle, taxonomy, navigation, resource 배치를 확인한다.
  • 05-operations/ 는 변경 기록과 검증 결과를 문서화한다.
  • 06-public-posts/ 와 루트의 4개 포스트는 실제 블로그 글처럼 읽히는지를 시험한다.

2) 트리 구조는 유지하고, 콘텐츠 밀도만 크게 올림

  • 폴더명과 파일명은 유지했다.
  • 내부 내용은 전면 재작성했다.
  • 구조가 유지되므로 배포 후 URL 변화가 최소화된다.
  • 운영자는 폴더 단위로 기능을 찾고, 페이지 단위로 렌더링을 확인할 수 있다.

3) 페이지 번들 리소스를 실제 본문 리소스로 사용

  • 04-architecture/bundles-resources/ 아래에 cover.svg, diagram.svg, pattern.svg 를 배치했다.
  • 이미지 설명은 주석이 아니라 실제 본문에서 읽히도록 구성했다.
  • 페이지와 리소스를 함께 복사하면 검증 결과도 함께 이동한다.

4) 카테고리/태그를 검토 친화적으로 정리

  • 넓은 주제는 카테고리로, 세부 키워드는 태그로 분리했다.
  • 같은 성격의 글이 한눈에 묶이도록 조합했다.
  • 나중에 카테고리/태그 페이지에서 빠르게 훑기 쉽게 설계했다.

5) 운영 문서와 검증 로그를 별도 페이지로 분리

  • upgrade-summary.md 는 이번 작업의 결과를 빠르게 보는 요약본이다.
  • verification-log.md 는 실제 확인 순서를 기록하는 체크리스트다.
  • update-log.md 는 변경 이유, 주의사항, 트리 구조를 남기는 장기 기록이다.

이번 패스에서 확인한 트리 구조

content/
└─ ko/
   └─ blog/
      └─ theme-upgrade-lab/
         ├─ _index.md
         ├─ 00-full-coverage.md
         ├─ 01-foundation/
         │  ├─ _index.md
         │  ├─ design-tokens.md
         │  ├─ color-surface.md
         │  ├─ layout-spacing.md
         │  └─ typography-language.md
         ├─ 02-components/
         │  ├─ _index.md
         │  ├─ controls-cards.md
         │  ├─ cta-shortcode.md
         │  └─ media-figure.md
         ├─ 03-rendering/
         │  ├─ _index.md
         │  ├─ markdown-rendering.md
         │  ├─ shortcode-composition.md
         │  └─ edge-cases.md
         ├─ 04-architecture/
         │  ├─ _index.md
         │  ├─ taxonomy-navigation.md
         │  └─ bundles-resources/
         │     ├─ index.md
         │     ├─ cover.svg
         │     ├─ diagram.svg
         │     └─ pattern.svg
         ├─ 05-operations/
         │  ├─ _index.md
         │  ├─ update-log.md
         │  ├─ upgrade-summary.md
         │  └─ verification-log.md
         ├─ 06-public-posts/
         │  ├─ _index.md
         │  ├─ 01-productivity-routine.md
         │  ├─ 02-budget-guide.md
         │  ├─ 03-weekend-cleanup.md
         │  └─ 04-travel-checklist.md
         ├─ 01-productivity-routine.md
         ├─ 02-budget-guide.md
         ├─ 03-weekend-cleanup.md
         └─ 04-travel-checklist.md

주의사항

  • 디자인은 theme-vars 에서만 조정한다.
  • 콘텐츠는 디자인을 설명하는 문서가 아니라 실제 렌더링을 드러내는 예시여야 한다.
  • 하드코딩된 특정 언어/로케일 경로는 추가하지 않는다.
  • 이번 패스는 content 외 코드에 손대지 않는다.

참고

이 문서는 이후 README를 작성할 때 기준점이 된다.
배포 직전에는 verification-log.md 의 체크 항목을 먼저 훑는 편이 안전하다.