왜 분리했나

화면 템플릿과 콘텐츠 원본의 수명이 다르기 때문이다. 게시물 목록, 상세 페이지, 메뉴 필터 같은 구조는 src/ 아래 Astro 파일에서 관리하고, 실제 글과 첨부 파일은 레포 최상위 posts/ 아래에 둔다.

작성 규칙

새 글은 메뉴별 디렉터리 안에 하나의 폴더로 만든다.

posts/logs/260510-post-page-convention/main.mdx

이미지, 음악, 다운로드 파일이 필요하면 같은 글 폴더 안에 함께 둔다. 예를 들어 images/, audio/, files/ 같은 하위 폴더를 둘 수 있다.

빌드 검증

빌드 과정에서 아래 항목을 확인한다.

  • 폴더명이 <YYMMDD>-kebab-name 형식인지
  • main.mdx의 menu가 상위 메뉴 디렉터리와 같은지
  • main.mdx의 date가 폴더명 날짜와 같은지
  • draft: true 글이 공개 목록에 나오지 않는지