42 lines
3.3 KiB
Markdown
42 lines
3.3 KiB
Markdown
# 파일-화면 매핑 가이드
|
|
|
|
## 현재 버전
|
|
- `v1.0.5`
|
|
|
|
## 공통 레이아웃
|
|
- [default.hbs](../default.hbs): 전체 3열 셸, 1296px 공통 폭 계산, 공통 자산 로드, 전역 공유 모달(`share-modal`) 마크업 포함
|
|
- [partials/site/sidebar-left.hbs](../partials/site/sidebar-left.hbs): 좌측 탐색(Primary `{{navigation}}`, Secondary `{{navigation type="secondary"}}`·`@site.secondary_navigation` 있을 때만)/Tags/카테고리 아코디언/푸터
|
|
- [page-tags.hbs](../page-tags.hbs): `slug=tags` 페이지용 태그 디렉터리
|
|
- [tags-index.hbs](../tags-index.hbs): `/tags/` 커스텀 라우트용 태그 디렉터리
|
|
- [partials/site/topbar.hbs](../partials/site/topbar.hbs): 상단 3열 헤더, 중앙 검색(최소 폭·라벨 말줄임), 좌측 사이드바 토글
|
|
- [partials/site/sidebar-right.hbs](../partials/site/sidebar-right.hbs): 우측 287px 사이드바, 포스트 상세 작성자 카드, Ghost Recommendations 기반 추천 링크/구독/푸터 구성
|
|
|
|
## 홈 및 목록
|
|
- [home.hbs](../home.hbs): 메인 홈
|
|
- [index.hbs](../index.hbs): 기본 목록 진입
|
|
- [partials/home/hero.hbs](../partials/home/hero.hbs): 홈 히어로 영역
|
|
- [partials/lists/post-feed.hbs](../partials/lists/post-feed.hbs): 홈 Featured 슬라이드, Latest 리스트, Categories(태그별 상위 5글) 묶음
|
|
- [partials/lists/home-categories.hbs](../partials/lists/home-categories.hbs): 홈 Latest 하단 태그별 최신 글 5개(텍스트 링크·우선순위 목록과 동일 정렬)
|
|
- [partials/lists/post-feed-archive.hbs](../partials/lists/post-feed-archive.hbs): 태그·작성자 아카이브용 글 목록 + Load More(페이지네이션)
|
|
- [partials/lists/post-items.hbs](../partials/lists/post-items.hbs): Tailwind 기반 리스트형 포스트 카드(요약·메타·`post-card-content` 세로 정렬), 댓글 아이콘, 우측 공유 액션(`data-share-*` 메타데이터 전달), 태그 accent 배지
|
|
|
|
## 상세 및 아카이브
|
|
- [post.hbs](../post.hbs): 포스트 상세
|
|
- [page.hbs](../page.hbs): 일반 페이지
|
|
- [tag.hbs](../tag.hbs): 태그 아카이브
|
|
- [author.hbs](../author.hbs): 작성자 아카이브
|
|
- [partials/post/post-navigation.hbs](../partials/post/post-navigation.hbs): 이전/다음 글 이동
|
|
|
|
## 자산
|
|
- [assets/built/screen.css](../assets/built/screen.css): 전체 스타일
|
|
- [assets/built/tailwind.css](../assets/built/tailwind.css): Tailwind 빌드 결과물
|
|
- [assets/built/alpine.js](../assets/built/alpine.js): Alpine.js 로컬 배포 파일
|
|
- [assets/built/theme.js](../assets/built/theme.js): 인터랙션 스크립트
|
|
- [partials/pagination.hbs](../partials/pagination.hbs): 다음 페이지가 있을 때만 표시되는 `Load More` 버튼
|
|
- [assets/styles/tailwind.css](../assets/styles/tailwind.css): Tailwind 입력 파일, `prose` 타이포그래피 규칙, accent/구분선 보조 유틸리티
|
|
- [tailwind.config.js](../tailwind.config.js): Tailwind 스캔 경로, 테마 설정, preflight 초기화 설정
|
|
- [scripts/dev-watch.js](../scripts/dev-watch.js): 로컬 파일 변경 감지 후 `dev:sync`와 Tailwind watch를 함께 실행하는 개발용 watcher
|
|
- [routes.yaml.example](../routes.yaml.example): Ghost 커스텀 라우트 예시
|
|
- [package.json](../package.json): Ghost 테마 메타데이터
|
|
- [package.json](../package.json): Ghost 테마 메타데이터, `zip:version` 압축 스크립트
|