ghost.sori.studio/docs/update.md

업데이트 로그

v0.2.7 - 2026-04-17

• package.json 버전을 0.2.7로 증가.
• partials/site/sidebar-left.hbs: @site.secondary_navigation이 있을 때 Home pages 아래에 More links 아코디언 그룹을 추가하고 {{navigation type="secondary"}}로 Secondary 링크를 노출.
• docs/spec.md, docs/map.md, docs/deploy.md 현재 버전을 v0.2.7로 동기화.
• docs/history.md에 Secondary 네비 사이드바 노출(v0.2.7) 기록.

v0.2.6 - 2026-04-17

• package.json 버전을 0.2.6으로 증가.
• 홈 Categories 좌측 색 막대: ::before+before:bg-accent 제거, tailwind.css의 .home-categories__row로 border-left: 3px solid var(--color-accent) 적용(가상 요소 content 누락으로 색이 안 보이던 문제 해소).
• docs/spec.md, docs/map.md, docs/deploy.md 현재 버전을 v0.2.6으로 동기화.
• docs/history.md에 Categories 액센트 표현 변경(v0.2.6) 기록.

v0.2.5 - 2026-04-17

• package.json 버전을 0.2.5로 증가.
• partials/lists/home-categories.hbs 수정: 좌측 액센트 바는 태그 accent_color(없으면 중립 회색)로 --color-accent 고정, 설명 없을 때는 문구 없음, 2열 그리드(2fr/3fr)로 좌우 간격 통일, 태그별 글은 get posts limit="5" 유지.
• docs/spec.md, docs/deploy.md 현재 버전을 v0.2.5로 동기화.
• docs/history.md에 홈 Categories 보정(v0.2.5) 의사결정 이력 추가.

v0.2.4 - 2026-04-17

• package.json 버전을 0.2.4로 증가.
• partials/lists/home-categories.hbs 추가: 홈 Latest 아래 Categories 섹션(태그당 최신 글 5개 텍스트 링크, 최대 10태그, data-category-priority-order 정렬).
• partials/lists/post-feed.hbs에서 Latest 이후 home-categories partial 포함.
• npm run build:tailwind로 assets/built/tailwind.css 재생성.
• docs/spec.md, docs/map.md, docs/deploy.md 현재 버전을 v0.2.4로 동기화.
• docs/history.md에 홈 Categories 섹션 추가(v0.2.4) 의사결정 이력 추가.

v0.2.3 - 2026-04-16

• package.json 버전을 0.2.3으로 증가.
• partials/lists/post-feed-archive.hbs 추가: 태그/작성자 아카이브용 글 목록 + 페이지네이션만(홈용 Featured·Latest 제외).
• tag.hbs, author.hbs에서 홈 전용 post-feed 대신 post-feed-archive를 사용하도록 변경.
• docs/spec.md, docs/map.md, docs/deploy.md 현재 버전을 v0.2.3으로 동기화.
• docs/history.md에 아카이브 피드 분리(v0.2.3) 의사결정 이력 추가.

v0.2.2 - 2026-04-16

• package.json 버전을 0.2.2로 증가.
• tag.hbs 태그 제목/설명(name, description)이 항상 렌더링되도록 {{#tag}} 컨텍스트를 명시 적용.

v0.2.1 - 2026-04-16

• package.json 버전을 0.2.1로 증가.
• routes.yaml.example에서 /authors/ 커스텀 라우트를 제거.
• 작성자 디렉터리 템플릿(authors-index.hbs, page-authors.hbs)을 제거해 개인용 블로그 구성에 맞게 정리.
• npm run dev, npm run dev:ghost:start 실행 시 로컬 메일 확인용 Mailpit 주소(http://localhost:8025, localhost:1025)를 함께 출력하도록 개선.
• docs/spec.md, docs/map.md, docs/deploy.md 현재 버전을 v0.2.1로 동기화하고 작성자 디렉터리 관련 내용을 제거.
• docs/history.md에 작성자 디렉터리 제거 의사결정 이력 추가.

v0.1.43 - 2026-04-16

• package.json 버전을 0.1.43으로 증가.
• docs/spec.md, docs/map.md, docs/deploy.md 현재 버전을 v0.1.43으로 동기화.
• docs/history.md에 v0.1.43 의사결정 이력(Read next 태그 우선화) 추가.
• partials/site/sidebar-right.hbs Read next 목록을 현재 글 primary_tag 기준 관련 글 우선 노출로 변경하고, 결과가 없으면 최신 글(현재 글 제외)로 fallback 처리.
• post.hbs 댓글 영역 분기를 comments 활성 여부 우선으로 재조정하고, 로그인 멤버에서 댓글 비활성화 시 전용 안내 문구를 노출하도록 수정.
• docker-compose.yml에 Mailpit 컨테이너를 추가하고 Ghost 메일 전송 설정(mail__*)을 로컬 SMTP로 연결.
• 로컬 멤버 테스트 계정 10개(localmember01@example.com~localmember10@example.com)를 Ghost DB에 생성.

v0.1.42 - 2026-04-16

• 좌측 카테고리 목록에 slug 기반 우선순위 정렬 기능 추가.
• 우선순위에 없는 태그는 게시물 수 내림차순 기본 순서를 유지하도록 정리.
• 카테고리 노출 제한을 우선순위 재정렬 이후 11개로 적용하도록 수정.
• partials/site/topbar.hbs 유저 메뉴 토글 스위치에 기준 마크업과 동일한 트랙/썸 전환 클래스를 보강해 활성 상태 대비를 개선.
• post.hbs 상단 메타 구분자(/)를 마지막 항목 제외 패턴으로 보정하고, 댓글 수를 항상 0으로 표시하도록 수정.
• 랜딩 샘플 템플릿(default-landing, custom-landing, page-landing-page) 및 관련 문서 항목 제거.
• assets/built/screen.css tag-hash-ld 기반 레이아웃 전환 규칙 제거.
• assets/built/theme.js 유저 메뉴 토글 트랙 배경을 활성 시 --accent, 비활성 시 --border로 명시 지정.
• partials/site/topbar.hbs, assets/built/screen.css 좌측 사이드바 토글 버튼을 이미지 2개 방식에서 상태/hover별 아이콘 4개 전환 방식으로 교체.
• post.hbs 댓글 비활성 안내 블록 텍스트/링크 색상을 text-typ, text-typ-tone, text-accent 기준으로 정리해 다크모드 대비를 보정.
• assets/built/screen.css tag-hash-ld 페이지에서 좌우 사이드바를 숨기고 .site-shell을 단일 블록/최대폭 720px으로 전환하도록 수정.
• assets/built/screen.css tag-hash-ld 페이지에서 topbar를 숨기도록 수정.
• assets/built/screen.css tag-hash-ld 페이지에서 .post-header를 숨기도록 수정.
• page.hbs 페이지 본문 래퍼의 상하 마진(mt-6, mb-8)을 제거.
• partials/site/topbar.hbs, assets/built/screen.css 좌측 사이드바 토글 아이콘 색상을 --text로 통일하고 hover 배경 변경을 제거.
• post.hbs 댓글 비활성 안내 영역의 Sign up now 버튼/Sign in 링크 색상을 브랜드 계열(bg-orange-600, text-orange-600)로 보정해 라이트 모드 가독성을 복구.
• post.hbs 댓글 영역 분기 조건을 comments에서 @member로 변경해 로그인 멤버는 댓글 0개 상태에서도 입력 UI가 노출되도록 수정.

v0.1.41 - 2026-04-16

• package.json 버전을 0.1.41로 증가.
• docs/spec.md, docs/map.md, docs/deploy.md 현재 버전을 v0.1.41로 동기화.
• docs/history.md에 v0.1.41 의사결정 이력(Portal 문구 치환 안정화) 추가.
• assets/built/theme.js Portal 문구 치환 로직을 메인 문서+iframe 탐색 기반 재시도 방식으로 보정하고, 상시 MutationObserver를 제거해 지연 가능성을 완화.

v0.1.40 - 2026-04-16

• 문서 버전 표기를 v0.1.40으로 정합성 수정.
• docs/history.md 의사결정 이력 최신 버전 항목 추가.
• 홈 히어로/탭 피드/태그 카드 원본 기준 보정 작업 반영 및 형식 정리.
• partials/site/sidebar-left.hbs Authors 섹션을 원본 구조 기준 아코디언/hover 인터랙션 형태로 수정.
• partials/site/sidebar-left.hbs Authors 헤더 양식을 Categories와 동일한 sidebar-card 패턴으로 통일하고, 썸네일/등급 텍스트/hover 점 전환 동작을 보정.
• partials/site/sidebar-left.hbs Authors 보조 텍스트를 role 우선 표시로 수정하고, 하단 네비게이션 닫힘 태그 오류(</footer>→</nav>)와 좌측 사이드바 하단 고정 레이아웃을 보정.
• partials/site/sidebar-left.hbs Authors hover 점 아이콘이 배경에 묻히던 문제를 대비 색/위치/전환값으로 보정해 항상 보이도록 수정.
• partials/site/sidebar-left.hbs Authors 보조 텍스트에서 location 노출을 제거하고 role만 표시하도록 수정.
• partials/site/sidebar-left.hbs Authors hover 점 아이콘 색상을 Tailwind 유틸리티 대신 --text 기반 color-mix 인라인 값으로 고정해 테마 색상과 충돌 없이 표시되도록 수정.
• partials/site/sidebar-left.hbs Authors hover 배경색을 #f5f5f5로 조정하고 hover 점 아이콘 대비를 더 진하게 보정.
• partials/site/sidebar-left.hbs Authors hover 점 아이콘 색상을 브랜드 액센트(--accent) 고정으로 변경.
• partials/site/topbar.hbs 우측 모바일 검색 버튼을 계정 버튼으로 교체하고, 로그인 시 멤버 아바타/비로그인 시 기본 유저 아이콘 노출로 수정.
• partials/site/topbar.hbs 유저 아이콘 클릭 시 열리는 사용자 메뉴 모달(계정/회원 액션, 다크모드 토글, 메뉴 열림 토글) 추가.
• partials/site/topbar.hbs 유저 메뉴가 아이콘 내부 SVG 클릭 시 즉시 닫히던 조건을 closest() 기반으로 수정하고, 데스크톱에서도 보이도록 유저 버튼 클래스를 분리.
• partials/site/topbar.hbs, assets/built/theme.js 유저 메뉴 모달 토글을 Alpine 의존에서 공통 스크립트 기반으로 전환해 클릭/외부 클릭 열고닫기와 스위치 상태 동기화를 안정화.
• partials/site/topbar.hbs, assets/built/theme.js 유저 메뉴 스위치 클릭 시 모달이 닫히지 않도록 이벤트 전파를 차단하고, 다크모드를 공통 setTheme() 직접 호출 방식으로 보정.
• assets/built/screen.css, assets/built/theme.js 데스크톱에서 사이드바는 화면 고정/중앙 본문만 스크롤되도록 레이아웃을 조정하고, 사이드바 영역 휠 입력을 중앙 본문 스크롤로 전달하도록 수정.
• home.hbs, partials/lists/post-feed.hbs 홈 피드 구조를 탭형에서 Featured 슬라이드 + Latest 리스트 구성으로 전환.
• assets/built/theme.js Featured 슬라이드 좌/우 버튼 스크롤 제어 및 비활성 상태 동기화 로직 추가.
• docs/spec.md, docs/map.md, docs/history.md 홈 피드 구조 변경 기준으로 문서 정합성 갱신.
• partials/lists/post-feed.hbs Featured 카드에서 썸네일 미존재 시 텍스트를 검은색으로 보정하고, 썸네일 카드와 동일한 라디우스/테두리 형태로 통일.
• assets/built/screen.css Featured 가로 슬라이드 스크롤바 비노출 처리 추가.
• partials/site/sidebar-right.hbs 우측 사이드바를 세로 플렉스 구조로 보정해 하단 footer가 화면 하단에 고정되도록 수정.
• assets/built/screen.css 좌측 Home pages 하위 링크의 배지/hover 동작을 원본처럼 사각 배지→원형 전환 및 현재 페이지 accent 표시로 보정.
• assets/built/screen.css, assets/built/theme.js 데스크톱 스크롤을 본문 전용 내부 스크롤에서 문서 스크롤로 전환해 스크롤바가 브라우저 우측에 표시되도록 정리.
• assets/built/screen.css 현재 활성화된 좌측 하위 메뉴 hover 시 배지가 회색으로 바뀌지 않고 accent 색상을 유지하도록 우선순위 보정.
• assets/built/screen.css 그리드 컨테이너 align-items를 보정해 사이드바 sticky 고정을 안정화하고, 스크롤 시 사이드바 동반 이동/푸터 이탈 현상을 완화.
• assets/built/screen.css h-full 클래스 우선순위로 깨지던 사이드바 뷰포트 고정을 sidebar.sidebar--* 선택자와 높이 보정으로 수정해 footer/nav가 화면 하단에 유지되도록 보정.
• assets/built/screen.css 하위 메뉴 hover 비활성 선택자에서 a:not(.nav-current) 조건을 제거해 활성 항목 hover 시 accent 배지가 회색으로 덮이지 않도록 수정.
• partials/lists/post-items.hbs 본문 요약 유무와 길이에 관계없이 카드 콘텐츠 높이가 균일하도록 콘텐츠 영역 높이/요약 최소 높이를 보정.
• partials/site/sidebar-right.hbs Recommended 섹션을 featured 글 목록에서 Ghost recommendations 데이터 기반 외부 링크 목록으로 전환하고, 항목별 favicon/타이틀 렌더링을 추가.
• docs/spec.md, docs/map.md 추천 섹션 데이터 소스 변경 기준으로 문서 정합성 갱신.
• partials/site/sidebar-right.hbs Recommended 목록 렌더링을 {{get}} 호출 대신 data-recommendations 기반 Portal 자동 주입 방식으로 전환.
• partials/site/sidebar-right.hbs, partials/recommendations.hbs Recommended를 공식 {{recommendations}} 헬퍼 기반 렌더링으로 전환하고 커스텀 recommendations partial을 추가.
• partials/lists/post-items.hbs 메타 구분자(/)를 직접 자식 선택자 기반으로 보정해 마지막 항목 뒤에는 표시되지 않도록 수정.
• partials/recommendations.hbs 추천 favicon 크기/라디우스를 원본 기준(18px, 8px)으로 보정.
• partials/site/sidebar-right.hbs, assets/built/theme.js Portal Recommendations 모달이 열릴 때 제목/설명을 버튼 데이터 속성(발견하기) 기준으로 치환하도록 보정.
• assets/built/theme.js Portal 문구 치환 로직을 메인 문서+iframe 탐색 기반 재시도 방식으로 보정하고, 상시 MutationObserver를 제거해 지연 가능성을 완화.

v0.1.39 - 2026-04-16

• tags-index.hbs 태그 카드 목록 마크업을 원본(Thred) 구조 기준으로 변환 수정.
• tags-index.hbs 태그 카드 좌측 보더/호버 배경이 각 태그 accent_color를 항상 사용하도록 수정.
• tags-index.hbs 태그 카드 호버 시 보더 색 변경을 제거하고 내부 배경만 accent_color 25%로 보이도록 수정.
• tags-index.hbs 태그 카드 좌측 보더 색을 인라인 border-left-color로 고정해 클래스 우선순위 영향 없이 항상 액센트 색이 표시되도록 수정.
• tags-index.hbs에서 accent_color 미지정 태그는 컬러 fallback을 제거해 좌측 포인트 컬러가 표시되지 않도록 수정.
• partials/home/hero.hbs 기존 히어로 섹션을 제거하고 원본 구조 기반 수동 구독 폼으로 교체, 미지원 클래스/Alpine 이벤트를 Ghost 동작 기준으로 정리.
• partials/home/tabbed-feed.hbs 탭/모바일 피드 선택 UI를 원본 구조 기준 Alpine 마크업으로 재구성하고, 피드/카테고리 데이터 바인딩은 기존 Ghost 헬퍼 흐름으로 유지.

v0.1.38 - 2026-04-14

• npm run zip:version 압축 스크립트 추가.
• 현재 버전 기준 업로드용 zip 생성 흐름 정리.

v0.1.37 - 2026-04-14

• 목록 페이지네이션을 링크 이동형에서 Load More 확장형으로 변경.
• 다음 페이지 HTML에서 목록만 파싱해 이어 붙이는 클라이언트 로직 추가.
• 다음 페이지가 없을 때 하단 버튼이 노출되지 않도록 수정.

v0.1.36 - 2026-04-14

• 로컬 Ghost routes.yaml에 /tags/, /authors/ 커스텀 라우트 추가.
• 좌측 네비게이션 Tags, Authors 링크가 각각 tags-index.hbs, authors-index.hbs를 타도록 로컬 환경 정리.
• tag.hbs는 개별 태그 아카이브, /tags/는 태그 목록 인덱스 역할로 구분 정리.

v0.1.35 - 2026-04-14

• author.hbs 작성자 아바타 크기와 fallback 표시 수정.
• tag.hbs의 불필요한 {{#tag}} 블록 제거.
• 태그 아카이브 페이지 pagination 컨텍스트 오류 수정.

v0.1.34 - 2026-04-14

• 우측 사이드바 마크업을 훅 클래스 유지형 Tailwind 구조로 다시 정리.
• 작성자 소개, 사이트 소개, 추천 목록, 구독 폼, 푸터 영역에 Tailwind 보조 클래스 재적용.

v0.1.33 - 2026-04-14

• 좌측 사이드바 데스크톱 닫힘 상태를 display:none 대신 폭/투명도 전환으로 수정.
• 좌측 사이드바 열기·닫기 애니메이션 복구.

v0.1.32 - 2026-04-14

• 공통 셸 레이아웃 훅 클래스를 유지한 채 Tailwind 보조 클래스 재적용.
• 헤더 1296px 셸 정렬과 중앙 검색바 배치 복구 방향 정리.
• 좌우 사이드바 폭 계산과 토글 동작을 깨지 않는 하이브리드 마크업으로 수정.

v0.1.31 - 2026-04-14

• npm run dev:watch 스크립트 추가.
• 로컬 파일 변경 감지 후 자동 dev:sync 반영 흐름 추가.
• Tailwind --watch와 테마 sync를 함께 사용하는 로컬 확인 루프 정리.

v0.1.30 - 2026-04-14

• prose 본문 타이포그래피 스타일 추가.
• ul, ol, blockquote, code, table 본문 표현 복구.
• bg-accent/10, hover:bg-accent/5, divide-brd 유틸리티 추가.
• 리스트형 post-card 하드코딩 클래스 정리.
• 리스트 메타 구분 슬래시 중복 출력 수정.

v0.1.29 - 2026-04-14

• Tailwind preflight 초기화 다시 활성화.
• assets/styles/tailwind.css에 base 레이어 추가.
• html, body 기본 폰트/색상 초기값 정리.

v0.1.28 - 2026-04-14

• 포스트 상세 헤더를 Tailwind 기준 마크업으로 재정리.
• 포스트 상단 중복 태그 표시 제거.
• 포스트 메타 행, 댓글 아이콘, 우측 공유 아이콘 위치 수정.
• 대표 이미지 비율과 상단 간격을 원본 기준으로 보정.

v0.1.27 - 2026-04-14

• 리스트형 post-card 항목 구분선 복구.
• 카드 콘텐츠 영역 min-w-0 적용으로 제목/본문 줄바꿈 폭 보정.
• 카드 정렬을 items-start 기준으로 재정리.

v0.1.26 - 2026-04-14

• 리스트형 post-card를 Tailwind 기준 마크업으로 재구성.
• 썸네일 비율을 aspect-square sm:aspect-video 기준으로 수정.
• 댓글/우측 액션 아이콘을 Tailwind 마크업 기준으로 재정리.
• assets/styles/tailwind.css에 카드용 보조 유틸리티 추가.

v0.1.25 - 2026-04-14

• 리스트형 post-card 마크업을 원본 구조 기준으로 재정리.
• 댓글 아이콘을 chat_bubble.svg로 교체.
• 우측 액션 아이콘을 arrow_outward.svg로 교체.
• 포스트 카드 썸네일/메타/공유 버튼 스타일 수정.

v0.1.24 - 2026-04-14

• 좌측 네비게이션 마커 hover 형태를 카테고리 마커와 동일하게 수정.
• 홈 히어로 문구 강조 및 구독 폼 레이아웃 재정리.
• 홈 피드 탭 버튼 스타일을 원본 기준으로 재정리.
• 리스트형 포스트 카드 썸네일 비율, 메타 배지, 간격 수정.
• 카테고리 탭 목록 행 스타일 및 순번 링크 표현 수정.

v0.1.23 - 2026-04-14

• 좌측 네비게이션 Tailwind/Alpine 구조로 재정리.
• 네비게이션 아코디언 슬라이드 애니메이션 유지.
• /tags/, /authors/ 커스텀 라우트용 템플릿 추가.
• routes.yaml.example 추가.

v0.1.22 - 2026-04-14

• 전역 리스트 리셋 추가.
• 카테고리 아코디언 화살표 상태 아이콘 수정.

v0.1.21 - 2026-04-14

• 카테고리 영역 Alpine.js 기반으로 재구성.
• 원본 기준 카테고리 패딩 및 hover 표현 재정리.
• Tailwind 커스텀 유틸리티 추가.
• page-tags.hbs, page-authors.hbs limit="100"으로 수정.
• 업로드 zip 제외 패턴 정리.

v0.1.20 - 2026-04-14

• Tags, Authors 좌측 메뉴 직접 링크형으로 변경.
• page-tags.hbs, page-authors.hbs 추가.
• Tailwind 로드 우선순위 수정.
• Alpine.js 로컬 자산 로드 추가.

v0.1.19 - 2026-04-14

• author.hbs 구식 author 블록 헬퍼 제거.
• Ghost 업로드 오류 대응 정리.

v0.1.18 - 2026-04-14

• 카테고리 아코디언 초기화 범위 수정.
• 카테고리 영역 반응형 기본 열림 상태 추가.
• 1024px 기준 카테고리 자동 열림/닫힘 동기화 추가.

v0.1.17 - 2026-04-13

• Tailwind CSS 빌드 파이프라인 추가.
• tailwind.css 생성 및 공통 레이아웃 로드 추가.
• topbar 영역에 Tailwind 유틸리티 부분 적용 시작.
• 개발 실행 시 Tailwind 빌드 선행되도록 스크립트 정리.

v0.1.1 - 2026-04-13

• 메인 3열 레이아웃 폭을 240 / 720 / 320 기준으로 재조정
• 포스트 실측 콘텐츠 폭을 680px 중심으로 정리
• Pretendard 웹폰트를 기본 폰트로 연결
• 업로드 패키지에 폰트 자산 포함

v0.1.0 - 2026-04-13

• Ghost 테마 기본 스캐폴드 추가
• default.hbs와 공통 사이드바/탑바 partial 구성
• 홈 히어로, 탭형 피드, 태그/작성자/포스트/페이지 템플릿 구현
• assets/built/screen.css에 Thred 스타일 기반 3열 레이아웃 및 반응형 CSS 추가
• assets/built/theme.js에 다크모드, 검색 오버레이, 탭 전환, 아코디언 토글 추가
• package.json, README.md 추가