/
Page Tree Macro

Page Tree Macro

지정된 상위 (루트) 페이지에서 시작하는 동적인 계층적 페이지 목록을 표시한다. 

목차 또는 관련 주제 목록으로 작동할 수 있다. 페이지 트리를 볼 때 독자는 링크를 클릭하여 관련 페이지를 볼 수 있다. 페이지의 현재 위치가 페이지 트리에서 강조 표시된다.

 

Page Tree Macro 사용

Page Tree Macro를 페이지에 추가하려면 :

  1. Confluence 편집기에서 삽입 > 다른 매크로 선택
  2. 필요한 매크로 찾기 및 선택

자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.

기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.

 

매크로 브라우저에서 새로고침을 클릭 하여 매크로 매개변수의 변경 사항을 확인한다.


매크로 매개변수

매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션. 

Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개변수 이름이 매크로 브라우저에서 사용된 레이블과 다른 경우, 아래에 대괄호 ( example) 로 표시된다.

매개변수

기본값

설명

루트 페이지 

(root

공간의

홈페이지

페이지 트리의 상위 페이지를 지정. 트리는 지정된 페이지의 모든 하위 페이지를 포함한다 . 트리에는 루트 페이지 자체가 포함 되지는 않는다. 

다음과 같이 페이지 제목이나 특수값을 지정

  • 페이지 제목 - 트리의 부모 또는 루트에 대한 페이지 이름을 지정. 트리는 지정된 루트의 모든 자식 및 그랜드 자식을 포함한다. 
    트리는 지정된 루트 페이지 자체를 포함하지 않는다.
  • '@home'- 스페이스의 홈페이지 아래에 모든 페이지가 포함(기본값)
  • '@self'- 현재 페이지 아래의 모든 페이지를 포함
  • '@parent'- 현재 페이지를 포함하여 현재 페이지의 부모 아래에 있는 모든 페이지를 포함
  • '@none'- 고아 페이지와 홈페이지를 포함하여 공간의 모든 페이지를 포함

페이지 정렬 기준

(sort

position 

트리에서 페이지를 표시할 순서를 지정. 이 정렬 순서는 표시용이다. 영구적으로 페이지 순서를 변경하지는 않는다. 값은 다음 중 하나일 수 있다.

  • bitwise - 알파벳 순서로 정렬(예 : title1, title10, title2)
  • creation - 생성 날짜순으로 정렬
  • modified - 마지막으로 수정된 날짜 순으로 정렬
  • natural - '자연적인'알파벳 순서로 정렬(예 : title1, title2, title10)
  • position - 기본 Confluence 정렬 규칙에 따라 정렬. 페이지가 수동으로 정렬된 경우 이 정렬은 정의된 순서를 따른다. 
    그렇지 않으면 페이지가 '자연적인'알파벳 순으로 표시된다.(예 : title1, title2, title10)

페이지 트리에 발췌 포함

(excerpt

false

페이지 트리에서 각 페이지의 발췌 내용을 표시하려면 선택. 

발췌문은 Excerpt 매크로에 의해 각 페이지에 정의되어야 한다.

역순

(reverse

false

자연 순서를 역순으로(내림차순으로) 표시하려면 선택. 

페이지 정렬 기준 매개 변수와 함께 사용해야 한다.

페이지 트리 위의

검색 창 포함

(searchBox

false

페이지 트리 위에 검색 창을 포함시키려면 선택. 

검색 창을 통해 독자는 페이지 트리 내에서 지정된 값을 검색 할 수 있다.

확장 / 축소 링크 표시

(expandCollapseAll

false

페이지 트리의 맨 위에 '모두 펼치기' 및 '모두 접기' 링크를 표시하려면 선택. 

독자는 이 링크를 클릭하여 트리의 모든 가지를 한 번에 열거나 닫을 수 있다.

wikimarkup 및 저장 형식의 사용 가능한 값 :

  • true - '모두 펼치기' 및 '모두 접기' 옵션을 표시
  • false - 옵션을 표시하지 않는다.

시작 깊이

(startDepth

1

0번보다 큰 숫자를 입력하여 트리가 처음 열릴 때 표시할 하위 수준 수를 설정

 

위키 마크 업 예제

이 예제는 편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로) 유용

매크로 이름 : pagetree

매크로 본문 :  없음

{pagetree:root=Page Name|sort=natural|excerpt=true|reverse=false|startDepth=3|expandCollapseAll=true|searchBox=true}