활용 사례
home
회사 브랜딩
home
🌊

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 코드 블럭이 동작하지 않는다면, 올바른 형식인지를 아래 링크에서 검사해보세요.

참고 문서