v0.1.20 태그 페이지 및 Alpine 적용
This commit is contained in:
96
docs/deploy.md
Normal file
96
docs/deploy.md
Normal file
@@ -0,0 +1,96 @@
|
||||
# 배포 가이드
|
||||
|
||||
## 현재 버전
|
||||
- `v0.1.20`
|
||||
|
||||
## Git 기본 설정
|
||||
- 저장소 작성자 정보는 아래 값으로 통일한다.
|
||||
- 이름: `zenn`
|
||||
- 이메일: `zenn.message@gmail.com`
|
||||
|
||||
```bash
|
||||
git config user.name "zenn"
|
||||
git config user.email "zenn.message@gmail.com"
|
||||
```
|
||||
|
||||
## 저장소 초기화
|
||||
```bash
|
||||
git init
|
||||
git branch -M main
|
||||
git remote add origin https://git.sori.studio/zenn/sori.studio.git
|
||||
```
|
||||
|
||||
## 작업 종료 시 업로드 절차
|
||||
1. 변경 파일과 문서 반영 상태를 확인한다.
|
||||
2. 작성자 정보가 올바른지 확인한다.
|
||||
3. 모든 변경을 스테이징한다.
|
||||
4. 한국어 커밋 메시지로 커밋한다.
|
||||
5. `main` 브랜치로 원격 저장소에 푸시한다.
|
||||
6. 마지막 커밋과 작업 트리가 정상인지 다시 확인한다.
|
||||
|
||||
```bash
|
||||
git config user.name
|
||||
git config user.email
|
||||
git status
|
||||
git add -A
|
||||
git commit -m "영역: 작업 내용"
|
||||
git push origin main
|
||||
git status
|
||||
git log -1 --oneline
|
||||
```
|
||||
|
||||
## 로컬 실행
|
||||
```bash
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
## 로컬 스타일 빌드
|
||||
```bash
|
||||
npm run build:alpine
|
||||
npm run build:tailwind
|
||||
```
|
||||
|
||||
- `npm run dev`, `npm run dev:ghost:start`, `npm run dev:ghost:restart` 실행 시 Alpine.js와 Tailwind 빌드가 먼저 수행된다.
|
||||
- Alpine 결과물은 `assets/built/alpine.js`에 생성된다.
|
||||
- Tailwind 결과물은 `assets/built/tailwind.css`에 생성되고, Ghost 테마에서 `screen.css`보다 먼저 로드된다.
|
||||
|
||||
## 로컬 빌드 검증
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
|
||||
## 저장 기능 메모
|
||||
- DB 연결 환경에서는 작성/수정 API가 Prisma를 통해 실제 데이터를 저장한다.
|
||||
- DB 미연결 환경에서는 샘플 콘텐츠 fallback이 프로세스 메모리에서만 갱신된다.
|
||||
- 따라서 재시작 이후에도 데이터를 유지하려면 PostgreSQL 연결이 필요하다.
|
||||
|
||||
## 폰트 에셋
|
||||
- `Pretendard` 폰트 파일은 `assets/fonts` 경로를 사용한다.
|
||||
- 전역 CSS 로딩에 `assets/fonts/pretendard.css`가 포함되어 있어야 한다.
|
||||
|
||||
## PostgreSQL 준비
|
||||
```bash
|
||||
cp .env.example .env
|
||||
npm run db:push
|
||||
npm run db:seed-admin
|
||||
```
|
||||
|
||||
## 데모 로그인 계정
|
||||
- 이메일: `zenn.message@gmail.com`
|
||||
- 비밀번호: `zenn-demo-admin`
|
||||
- 실제 운영 전에는 `.env`에서 데모 인증 값을 반드시 변경한다.
|
||||
|
||||
## 관리자 계정 시드
|
||||
- DB 연결 환경에서는 `npm run db:seed-admin`으로 초기 관리자 계정을 생성하거나 갱신한다.
|
||||
- 시드 계정 정보는 `.env`의 `DEMO_ADMIN_*` 값을 사용한다.
|
||||
- 실제 운영 전에는 기본 비밀번호를 반드시 변경한다.
|
||||
|
||||
## 원격 저장소 정보
|
||||
- 기본 원격 이름: `origin`
|
||||
- 기본 저장소 주소: `https://git.sori.studio/zenn/sori.studio.git`
|
||||
|
||||
## 운영 메모
|
||||
- 민감 정보가 포함된 파일은 커밋 전에 반드시 확인한다.
|
||||
- 문서 변경이 발생한 작업은 코드와 함께 같은 커밋에 포함한다.
|
||||
- 배포 절차가 확정되면 UGREEN NAS Docker 배포 방법을 이 문서에 이어서 추가한다.
|
||||
@@ -1,5 +1,8 @@
|
||||
# 의사결정 이력
|
||||
|
||||
## 2026-04-14 v0.1.20
|
||||
앞으로 원본 테마 섹션 코드를 더 직접적으로 참고할 수 있도록 Alpine.js를 로컬 자산으로 포함하기로 했다. 외부 CDN 의존 대신 테마 빌드 단계에서 `assets/built/alpine.js`를 생성해 함께 배포하고, 기존 `theme.js`는 즉시 제거하지 않고 공존시키면서 점진적으로 Alpine 문법을 허용하는 방향으로 정리했다.
|
||||
|
||||
## 2026-04-14 v0.1.19
|
||||
Ghost 업로드 오류에 맞춰 `author.hbs`의 구식 `{{#author}}` 블록 헬퍼를 제거했다. 작성자 아카이브 템플릿은 이미 작성자 컨텍스트에서 렌더링되므로, 별도 블록 헬퍼 없이 현재 컨텍스트 값을 직접 사용하는 방식이 Ghost 최신 검사 기준과도 맞다.
|
||||
|
||||
|
||||
@@ -1,11 +1,13 @@
|
||||
# 파일-화면 매핑 가이드
|
||||
|
||||
## 현재 버전
|
||||
- `v0.1.18`
|
||||
- `v0.1.20`
|
||||
|
||||
## 공통 레이아웃
|
||||
- [default.hbs](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/default.hbs): 전체 3열 셸과 공통 자산 로드
|
||||
- [partials/site/sidebar-left.hbs](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/partials/site/sidebar-left.hbs): 좌측 탐색/카테고리 아코디언/작성자/푸터
|
||||
- [partials/site/sidebar-left.hbs](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/partials/site/sidebar-left.hbs): 좌측 탐색/직접 링크형 Tags·Authors 메뉴/카테고리 아코디언/푸터
|
||||
- [page-tags.hbs](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/page-tags.hbs): `slug=tags` 페이지용 태그 디렉터리
|
||||
- [page-authors.hbs](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/page-authors.hbs): `slug=authors` 페이지용 작성자 디렉터리
|
||||
- [partials/site/topbar.hbs](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/partials/site/topbar.hbs): 상단 검색/CTA/다크모드
|
||||
- [partials/site/sidebar-right.hbs](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/partials/site/sidebar-right.hbs): 구독/추천/작성자/푸터
|
||||
|
||||
@@ -26,6 +28,7 @@
|
||||
## 자산
|
||||
- [assets/built/screen.css](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/assets/built/screen.css): 전체 스타일
|
||||
- [assets/built/tailwind.css](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/assets/built/tailwind.css): Tailwind 빌드 결과물
|
||||
- [assets/built/alpine.js](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/assets/built/alpine.js): Alpine.js 로컬 배포 파일
|
||||
- [assets/built/theme.js](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/assets/built/theme.js): 인터랙션 스크립트
|
||||
- [assets/styles/tailwind.css](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/assets/styles/tailwind.css): Tailwind 입력 파일
|
||||
- [tailwind.config.js](/Users/bicute/Desktop/UGREEN/GHOST%20THEME/tailwind.config.js): Tailwind 스캔 경로 및 테마 설정
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 기술 명세
|
||||
|
||||
## 현재 버전
|
||||
- `v0.1.19`
|
||||
- `v0.1.20`
|
||||
|
||||
## 테마 개요
|
||||
- Ghost `v5` 대응 커스텀 테마
|
||||
@@ -14,8 +14,10 @@
|
||||
- 검색 오버레이, 탭 전환, 다크모드 토글용 프런트 스크립트
|
||||
- Ghost `navigation`, `get`, `subscribe_form`, `comments`, `pagination` 헬퍼 사용
|
||||
- Tailwind CSS 빌드 결과물(`assets/built/tailwind.css`)을 기존 `screen.css`와 함께 로드
|
||||
- Alpine.js 로컬 자산(`assets/built/alpine.js`)을 전역 로드
|
||||
- 좌측 카테고리 영역은 `1024px` 이상에서 기본 열림, 미만에서 기본 닫힘
|
||||
- `author.hbs`는 페이지 컨텍스트의 작성자 데이터를 직접 사용
|
||||
- `page-tags.hbs`, `page-authors.hbs`는 각각 `slug=tags`, `slug=authors` 페이지에 연결 가능
|
||||
|
||||
## 주요 스타일 방향
|
||||
- 밝은 크림톤 배경 + 오렌지 포인트
|
||||
|
||||
@@ -1,5 +1,11 @@
|
||||
# 업데이트 로그
|
||||
|
||||
## 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 업로드 오류 대응 정리.
|
||||
|
||||
Reference in New Issue
Block a user