Cloudwiki

Cloudwiki/설정/컬러 팔레트

# 개요

Cloudwiki에서 컬러 팔레트를 설정하는 방법에 대해 다룹니다.

일반 색상 문법에서  두가지 정보를 매번 모두 입력하면 가독성과 작성 편의성이 떨어질 수 있습니다.
자주 사용하는 색상을 팔레트로 만들어 관리하세요.

관리자 콘솔의 컬러 팔레트 관리 UI에서 데이터베이스에 직접 저장됩니다. 별도의 재배포 없이 즉시 반영됩니다.

# 방법

## 관리자 콘솔 접속

`/admin` 으로 이동한 뒤 `콘텐츠 관리` 섹션의 컬러 팔레트 관리를 엽니다. (관리자 권한 필요)

## 팔레트 생성

1. 이름입력
프리셋(`primary`/`secondary`/`success`/`info`/`warning`/`danger`/`muted`)은 예약되어 사용할 수 없습니다.
2. 배경색 / 글씨색 을 컬러 피커 또는 HEX 입력란으로 지정합니다. 배경색을 고르면 명도 대비에 따라 글씨색이 자동으로 흰색/검정으로 제안됩니다 (변경 가능).
3. 다크 모드 색상 분리 체크박스를 켜면 다크 모드 전용 배경/글씨색 입력란이 추가로 표시됩니다. 끄면 라이트 모드 색상이 다크 모드에서도 그대로 사용됩니다.
4. 폼 하단의 실시간 뱃지 프리뷰 에서 라이트/다크 양쪽 모습을 즉시 확인할 수 있습니다.
5. 저장 버튼을 누르면 즉시 반영되며 페이지 새로고침 없이 목록에 추가됩니다.

## 팔레트 수정 / 삭제

목록에서 기존 팔레트를 클릭하면 폼에 값이 채워져 수정 모드로 진입합니다. 이름은 변경할 수 없습니다. 이름을 바꾸려면 새로 만들고 기존 항목은 삭제하세요.

삭제 시 본문에 남아 있는 `{palette:이름}` 토큰은 정리되지 않습니다. 해당 문서를 재저장하면 자동으로 색인에서 제거됩니다.

# 사용

배포가 완료되면 에디터에서 제작했던 컬러 팔레트를 간편하게 사용할 수 있습니다.

컬러 팔레트를 사용하는 방법은 [[Cloudwiki/위키 문법 가이드#3.6.2]] 문서를 참고하세요.

# 동작 방식

* 프리셋 7종은 모든 페이지에서 항상 사용 가능합니다. 같은 이름의 커스텀 팔레트는 만들 수 없습니다.