Cloudwiki/설정/테마

# 개요

Cloudwiki 는 사이트 전체의 색 팔레트는 물론 **글꼴 · 밀도(여백/행간) · 모서리**까지 **테마(스킨)** 단위로 통째 교체할 수 있습니다. 테마는 운영자가 `wrangler.toml` 에서 지정하며, 두 가지 운영 방식이 있습니다.

- **단일 테마** — `WIKI_THEME` 하나로 사이트 전역 색을 고정합니다.
- **사용자 선택형 멀티 스킨** — `WIKI_THEMES` 에 여러 테마를 등록하면, 방문자가 개인 설정에서 직접 색 테마를 고를 수 있습니다.


# 테마 적용

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

```
WIKI_THEME = "default"   # Cloudwiki (빌트인 기본 테마)
WIKI_THEME = "astro"     # AstroShell (다크 전용)
WIKI_THEME = "via"       # VIA (뉴모피즘)
```

- `"default"` (또는 미지정) 은 빌트인 기본 테마 **Cloudwiki** 를 사용합니다.
- 값을 바꾸면 빌드 타임에 색 · 글꼴 · 밀도 · 모서리 토큰이 통째로 교체되어 사이트 전역에 적용됩니다.

# 사용자 선택

`wrangler.toml` 의 `WIKI_THEMES` 에 **둘 이상**의 테마 이름을 콤마로 등록하면, 헤더의 **개인 설정 → 색 테마** 에서 방문자가 직접 테마를 고를 수 있습니다.

```
WIKI_THEME  = "astro"          # 사용자가 안 고르면 쓸 기본 선택 테마
WIKI_THEMES = "default,astro"  # 사용자가 고를 수 있는 테마 목록
```

- 선택은 **각자의 브라우저**에 저장되어 사용자마다 다르게 적용되며, 즉시 반영됩니다.
- 한 개 이하만 등록하면 위의 단일 테마 모드로 동작합니다.
- 등록한 모든 테마는 사용자가 무엇이든 고를 수 있으므로, 각 테마가 명암비(가독성) 기준을 만족해야 합니다.

# 라이트 / 다크 모드

테마는 **라이트 · 다크** 두가지 색을 가지며, 방문자는 개인 설정에서 라이트, 다크, 시스템 자동 중 하나를 고를 수 있습니다(색 테마 선택과는 별개의 축).

단, **다크 모드 전용 테마**(예: [[Cloudwiki/설정/테마/Astro|Astro]])가 활성인 동안에는 밝기가 **다크로 고정**되고 라이트/다크 토글이 숨겨집니다. 멀티 스킨 모드에서 다크 전용이 아닌 다른 테마로 바꾸면 밝기 선택이 다시 나타납니다.

# 사용 가능한 테마

- [[Cloudwiki/설정/테마/Cloudwiki]]
- [[Cloudwiki/설정/테마/Astro]] (다크 모드 전용)
- [[Cloudwiki/설정/테마/벡터]]
- [[Cloudwiki/설정/테마/VIA]]