Files
ghost.sori.studio/docs/update.md
2026-04-16 17:40:06 +09:00

212 lines
16 KiB
Markdown

# 업데이트 로그
## 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 처리.
## 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`)로 보정해 라이트 모드 가독성을 복구.
## 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` 추가