Theme guidelines

이 페이지는 안정적이고 유지보수 가능한 테마를 구축하기 위한 권장 사항을 나열합니다. 이 가이드라인을 따르면 향후 Obsidian 버전과 함께 테마를 업데이트하는 데 필요한 유지보수 작업을 최소화할 수 있습니다.

개발자를 위한 일반적인 가이드라인에 대한 자세한 내용은 Developer policies를 참조하세요.

CSS 변수 사용

Obsidian의 대부분의 사용자 인터페이스는 CSS 변수를 사용하므로, 기본 제공 CSS 변수를 재정의하는 것만으로도 매우 표현력 있는 테마를 만들 수 있습니다.

일반 변수는 body 아래에서, 색상은 .theme-light 또는 .theme-dark 아래에서 재정의하세요.

:root {
  --input-focus-border-color: Highlight;
}
 
body {
  --font-text-size: 18px;
}
 
.theme-light {
  --background-primary: white;
}
 
.theme-dark {
  --background-primary: black;
}

낮은 특이도 선택자 사용

특정 클래스를 대상으로 하는 지나치게 복잡한 선택자는 피하세요. CSS 변수 사용으로 선택자를 단순하게 유지하세요.

테마를 유지보수할 때 가장 흔히 발생하는 문제는 Obsidian의 새 버전으로 인해 클래스 이름과 요소 중첩 방식이 변경되어 선택자가 깨지는 경우입니다.

자산을 로컬로 유지

개발자 정책에 따라 커뮤니티 테마는 사용자가 오프라인 상태일 때 사용할 수 없는 글꼴 및 이미지와 같은 원격 자산을 로드해서는 안 됩니다. 사용자가 인터넷에 액세스할 수 있는 경우에도 원격 자산을 로드하면 사용자 개인 정보를 침해할 수 있습니다.

공식 커뮤니티 테마 디렉토리에 테마를 제출하려는 경우 네트워크 호출을 하지 않아야 하므로 모든 리소스를 테마에 번들로 포함해야 합니다. 가이드 테마에 글꼴 및 이미지 포함하기를 참조하세요.

!important 선언 피하기

스타일을 !important로 선언하면 사용자가 스니펫을 사용하여 테마의 스타일을 재정의할 수 없습니다.