🌊

YAML 로 페이지별 설정하기

어떤 경우에 쓰나요?

우피는 어드민 콘솔을 통해 코딩 없이도, 노션으로 만들어진 웹페이지의 여러 부분을 수정할 수 있는 기능을 제공합니다. 예를 들어, 테마를 변경할 수도 있고 검색 버튼을 숨기고 보일 수도 있습니다.

어드민 콘솔

그런데 때로, 전체 사이트에 위 옵션들을 적용하는 것이 아니라 특정 페이지에만 특정 옵션을 적용하고 싶을 경우가 있습니다. 예를 들어, 특정 페이지에서만 ‘페이지 경로’를 숨기거나 ‘페이지 제목’을 숨겨야 할 때가 있죠.

그럴 때 사용할 수 있는 것이 페이지별 YAML 코드 블럭 기능입니다. 사이트 전체에 적용한 옵션과 다른 옵션을 ‘특정 페이지’에만 적용할 수 있습니다.

페이지별 YAML 코드 블럭 레퍼런스 문서를 보면, 어떤 설정들을 페이지별로 조절할 수 있는 지 보실 수 있습니다. 내가 원하는 설정이 YAML 로 가능한 지, 이 페이지에서 확인해보세요. 생각보다 많은 것들을 페이지별로 설정할 수 있어요.

이 문서에는 몇가지 사용 예시를 알아보기로 합니다.

YAML 로 설정한 기능은 전체 기능보다 더 우선 순위가 높습니다. 무슨 말이냐면요. 어드민 콘솔에서 기능 A를 설정하고, 특정 페이지에서 YAML 을 통해 기능 A를 끄거나 다른 옵션을 설정한 경우, YAML 로 설정한 내용이 더 우선순위를 갖는다는 의미입니다.

그러니 꼭, 기능을 잘 이해하고 있고, 의도한 내용만 YAML 코드 블럭으로 작성해주세요.

아래와 같은 YAML 코드 블럭이 페이지 최상단에 있으면 어떻게 될까요?

hideBreadcrumbs: true
hideSearch: true
hideNotionTitle: true
topNavigator: null
showShareButton: false
showThemeButton: false
YAML
복사

페이지별 YAML 코드 블럭 레퍼런스 를 참조하면, 위 코드 블럭이 의미하는 바는 다음과 같습니다.

해당 코드 블럭이 있는 페이지에서

•

페이지 경로 표시를 숨기고,

•

검색 버튼을 숨기고,

•

노션 제목을 숨기고,

•

상단 메뉴바를 숨기고,

•

공유 버튼을 숨기고,

•

테마 버튼을 숨겨라

적용하면, 아래의 페이지와 같이 관련 부분이 숨겨집니다. 아래 페이지는 이 페이지를 복제한 페이지로, 모든 설정이 동일하지만 상단 관련 메뉴들이 숨겨진 것을 확인하실 수 있습니다. (상단 메뉴가 없으니, 이 페이지로 돌아오시려면 ‘뒤로 가기’를 통해 돌아오세요)

•

YAML 은 형식이 매우 중요한 언어입니다. 만약 YAML 코드 블럭이 동작하지 않는다면, 올바른 형식인지를 아래 링크에서 검사해보세요.

•

페이지별 HTML 코드 블럭  과 페이지별 YAML 코드 블럭 은 동시에 사용 가능합니다. 순서와 관계없이 두 블럭이 페이지 최상단에 있으면 됩니다.