테마

테마는 색 구성의 정의입니다. Misskey 본체와 같은 형식이므로, NoteDeck에서 만든 테마는 일반 Misskey에도 그대로 배포할 수 있습니다.

색 구성이 아니라 레이아웃이나 요소의 표시·숨기기를 바꾸고 싶다면 외관 바꾸기의 커스텀 CSS를 씁니다.

구조

JSON5로 씁니다. 키의 따옴표 생략, 끝의 쉼표, 주석을 쓸 수 있습니다.

json5

{
  id: '679b3b87-a4e9-4789-8696-b56c15cc33b0',  // 필수. UUID가 관례
  name: '테마 이름',                             // 필수
  base: 'dark',                                 // 'light' 또는 'dark'
  desc: '짧은 설명',                             // 선택
  author: '@user@host',                         // 선택
  props: { /* 색 정의 */ },
}

props에 쓰지 않은 키는 base에 지정한 표준 테마의 값이 쓰입니다. 전부 쓸 필요는 없으며, 바꾸고 싶은 곳만 쓰면 동작합니다.

id는 덮어쓰기의 키입니다. 같은 id로 다시 설치하면 기존 테마가 교체되므로, 새 테마에는 반드시 새 id를 붙이세요.

값 쓰는 법

리터럴 색 — '#f00' '#ff0000' '#ff000080' (8자리는 알파 포함) 'rgb(255, 0, 0)' 'rgba(255, 0, 0, 0.5)'

참조 — '@accent'처럼 같은 테마의 다른 값을 씁니다. 참조한 곳이 다시 참조나 함수여도 해석됩니다. 존재하지 않는 이름을 참조하면 빈 값이 되어 그 색이 사라집니다. 오타에 주의하세요.

함수 — :함수<인수<값 형태로 색을 가공합니다. 닫는 괄호는 쓰지 않습니다.

함수	효과
`:lighten<10<@accent`	밝게 합니다
`:darken<10<@accent`	어둡게 합니다
`:alpha<0.3<@accent`	불투명도를 바꿔 넣습니다 (곱하기가 아님)
`:hue<20<@accent`	색상을 회전합니다
`:saturate<15<@accent`	채도를 올립니다 (음수면 내립니다)

':alpha<0.5<:lighten<10<@accent'처럼 중첩할 수 있습니다. 여기에 없는 함수 이름은 해석되지 않고 문자열이 그대로 나와 깨져 보입니다. 함수의 입력으로 red 같은 색 이름은 쓸 수 없습니다.

원시 CSS — 맨 앞에 "를 하나 두면 그 뒤가 그대로 CSS 값이 됩니다. 닫지 않습니다. 다른 값은 var(--MI_THEME-속성이름)으로 참조할 수 있습니다.

json5

panelBorder: '" solid 1px var(--MI_THEME-divider)',

$상수는 쓸 수 없습니다

Misskey 본체의 테마 형식에는 props 안에서 $이름으로 상수를 정의하는 사양이 있지만, NoteDeck은 지원하지 않아 빈 값이 됩니다. @ 참조로 대신하세요.

만들기와 배포하기

AI 칼럼에서 "○○ 느낌의 테마를 만들어 줘"라고 부탁할 수 있습니다. 직접 쓴다면 설정 폴더에 둡니다. 만든 것은 MisStore에서 배포할 수 있습니다 (제출 방법 / 형식).

테마 ​

구조 ​

값 쓰는 법 ​

만들기와 배포하기 ​

테마

구조

값 쓰는 법

만들기와 배포하기