Cloudwiki/설정/테마

# 개요

Cloudwiki 는 사이트 전체의 색 팔레트를 **테마(스킨)** 단위로 통째 교체할 수 있습니다. 테마는 운영자가 배포(빌드) 시점에 고정하는 값으로, `wrangler.toml` 의 `WIKI_THEME` 변수로 지정합니다.

기본 테마는 [[Cloudwiki/설정/테마/VIA|VIA]] 이며, 추가로 [[Cloudwiki/설정/테마/Astro|Astro]] 테마를 제공합니다.

# 테마 적용 방법

`wrangler.toml` 의 `[vars]` 에서 `WIKI_THEME` 값을 원하는 테마 이름으로 설정한 뒤 다시 배포합니다.

```
WIKI_THEME = "default"   # VIA (빌트인 기본 테마)
WIKI_THEME = "astro"     # AstroShell
```

- `"default"` (또는 미지정) 은 빌트인 기본 테마 **VIA** 를 사용합니다.
- 값을 바꾸면 빌드 타임에 색 토큰이 통째로 교체되어 사이트 전역에 적용됩니다.
- 테마는 **운영자 빌드타임 설정**이므로, 일반 방문자가 런타임에 바꾸는 값이 아닙니다.

# 라이트 / 다크 모드

각 테마는 **라이트 모드와 다크 모드** 두 벌의 색을 함께 가집니다. 방문자는 헤더의 개인 설정에서 라이트 · 다크 · 시스템 자동 중 하나를 선택할 수 있으며, 이는 테마(스킨) 선택과는 별개로 동작합니다.

# 사용 가능한 테마

- [[Cloudwiki/설정/테마/VIA]] — 기본 테마. 청록(cyan) 계열.
- [[Cloudwiki/설정/테마/Astro]] — 딥 스페이스 글래스모피즘, 네뷸라 퍼플 계열.

# 새 테마 추가

새 색 테마는 코드 레벨에서 모듈식으로 추가합니다. `scripts/themes.mjs` 의 `THEMES` 레지스트리에 색 토큰 오버라이드(스킨)를 한 항목 추가하고, `wrangler.toml` 의 `WIKI_THEME` 에 그 이름을 지정하면 됩니다. 오버라이드 가능한 색 토큰 계약과 빌드 타임 베이킹 구조는 개발 문서(`DESIGN.md`)를 참고하세요.