macro 소개

Confluence 의 side bar 를 계층 구조로 표시할 수 있는 Page Tree 는 유용하지만 하위 페이지가 여러 단계에 있을 경우 브라우징이 불편합니다.

첨부 그림처럼 하위 페이지는 상단의 하위 페이지 펼침 버튼을 일일이 클릭해서 여러 단계를 거쳐야 접근할 수 있습니다.

children 매크로는 현재 페이지의 하위 페이지를 계층적으로 표시하는 매크로로 페이지가 계층적으로 되어 있을 경우 children macro 를 사용하면 일일이 하위 페이지를 클릭하지 않고도 현재 페이지에 계층적으로 표시 할 수 있습니다.

사용하려면 매크로 목록에서 children 을 누르면 됩니다.

macro 파라미터

여러 파라미터가 있는데 제가 즐겨 쓰는 파라미터는 다음과 같습니다.

Parameter	기본 값	설명
Parent Page	current	하위 페이지를 표시할 기준 페이지를 설정하며 생략시 현재 페이지가 됩니다.
Number of Children	none	몇 개의 하위 페이지를 표시할 지 여부입니다. 기본은 제한없음입니다.
Depth of Descendants	none	하위 페이지를 표시할 depth 로 기본값은 한 단계 아래 하위 페이지만 표시합니다. 위 예시는 2로 설정했으므로 2단계로 표시했습니다.
Heading Style	none	하위 페이지중 상위 페이지를 표시할 style 을 지정합니다. 위 예시는 h4 로 설정해서 현재 페이지의 하위 페이지 제목을 h4 로 표시했습니다.

"Depth of Descendants" 과 "Heading Style" 을 적용 안 했을 경우 아래와 같이 밋밋하게 표시되므로 저는 2개 파라미터를 즐겨 사용합니다.