/
Table of Content Zone Macro

Table of Content Zone Macro

목차를 만들 페이지 내의 섹션 (영역)을 표시 할 수 있다. 

제목을 플랫 목록으로 스타일을 지정하고 링크 목록을 섹션 또는 페이지의 상단과 하단에 배치하여 웹 탐색과 유사한 탐색 모음을 제공할 수 있다.

 

Table of Content Zone Macro 사용

Table of Content Zone Macro를 페이지에 추가하려면 : 

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

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

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

 

매개변수

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

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

매개변수

기본값

설명

위치(location

both

영역에서 출력 목록이 표시되는 위치를 지정(페이지 영역 내용을 포함하는 topbottom 또는 both)

출력 유형(type

list

목차의 레이아웃을 지정

  • list - TOC의 전형적인 세로 목록
  • flat - 수평 메뉴 유형의 일련의 링크 생성(예 : [제목 1] [제목 2] [제목 3])

섹션 번호 매기기 표시(outline

false

머리말에 개요 번호 매기기를 적용하려면 선택(예 : 1.1, 1.2, 1.3)

목록 스타일(style

없음

각 목록 항목의 글 머리표 스타일을 지정. 유효한 CSS 스타일을 사용할 수 있다. 예 :

  • none - 목록 스타일이 표시되지 않는다.
  • circle - 목록 스타일이 원이다.
  • disc - 목록 스타일은 채워진 원이다. 이것은 일반적인 글 머리 기호 목록이며 이 예제 목록에 사용 된 것이다.
  • square - 목록 스타일은 정사각형이다.
  • decimal - 목록의 번호가 매겨진다.(1, 2, 3, 4, 5)
  • lower-alpha - 목록은 소문자이며 알파벳순으로 표시된다.(a, b, c, d, e)
  • lower-roman - 목록 스타일은 낮은 로마 숫자(i, ii, iii, iv, v, vi)
  • upper-roman - 목록 스타일은 상위 로마 숫자(I, II, III, IV, V, VI)

제목 들여 쓰기(indent

 

CSS 수량에 따라 목록 출력 유형의 들여 쓰기를 설정. "10px"를 입력하면 목록 제목 레벨이 10px만큼 들여 쓰기된다. 

예를 들어, h1 제목은 10px 들여 쓰여지고 h2 제목은 10px 들여 쓰기된다.

구분 기호(separator

brackets

 플랫 출력 유형에만 적용링크의 표시 스타일을 지정한다. 다음 값 중 하나를 입력할 수 있다.

  • brackets - 각 항목은 대괄호로 묶는다 : []
  • braces - 각 항목은 중괄호로 묶는다 : {}
  • parens - 각 항목은 괄호로 묶는다 : ()
  • pipe - 각 항목은 파이프로 구분된다.
  • anything - 각각은 입력한 값으로 구분된다. 구분자로 텍스트를 입력할 수 있다(예 : '***'). 
    사용자 정의 분리 문자를 사용하는 경우 문자가 정확하게 입력된 대로 표시되며 추가 공백없이 문자를 더 구분할 수 있다.

최소 제목 수준(minLevel

1

가장 큰 제목 수준을 선택하여 목차 목록을 시작. 예를 들어, 2는 h2, h3 및 h4 제목을 나열하지만 h1 제목은 포함하지 않는다.

최대 제목 수준(maxLevel

7

목차에 포함시킬 가장 작은 제목 수준을 선택. 예를 들어, 2는 h1과 h2를 나열하지만 h3 이하는 포함하지 않는다.

제목 포함(include

 

특정 기준에 따라 포함된 제목을 필터링. 와일드 카드 문자를 사용할 수 있다. 정규 표현식 문자열을 만드는 예제는 Sun의 Regex 설명서 를 참조.

제목 제외(exclude

 

특정 기준에 따라 제목을 제외. 와일드 카드 문자를 사용할 수 있다. 정규 표현식 문자열을 만드는 예제는 Sun의 Regex 설명서 를 참조.

인쇄 가능(printable

true

기본적으로 목차는 인쇄하도록 설정되어 있다. 이 매개변수를 지우면 페이지를 인쇄할 때 목차가 표시되지 않는다.

CSS 클래스 이름(class

 

CSS 스타일 시트에 사용자 정의 목차가 있는 경우 이 매개변수를 사용하여 지정된 "class" 속성으로 목차를 출력할 수 있다.

 

 

예제

예제는 다음 제목이 있는 페이지를 기반으로 한다.

필터링된 목차

이 예는 모든 제목을 필터링하여 "즐겨 찾기"가 포함된 제목을 포함하지만 단어 "물건"으로 끝나는 제목은 제외한다. 목록은 대문자 로마 숫자로 표시된다.

매개변수
출력 유형list
목록 스타일upper-roman
제목 포함

Favourite.*

제목 제외.*Things

스크린 샷 : 필터링된 TOC '영역'제목

평면 목록

이 예에서는 모든 머리글을 필터링하여 대괄호로 묶인 "Unknowns"목록을 렌더링한다.

매개 변수
출력 유형flat
분리 기호brackets
최대 제목 수준2
제목 포함
Unknown.*

스크린 샷 : 평면 목록으로 표시된 필터링된 TOC '영역'제목

위키 마크 업 예제

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

매크로 이름 : toc-zone

매크로 본문 :  서식있는 텍스트를 허용

{toc-zone:printable=false|maxLevel=2|minLevel=2|location=top|type=flat|outline=true|separator=pipe} 
Only headings within this block are included in the table of contents. 
{toc-zone}

노트

  • 내용 영역 테이블 매크로(CONF-10619)의 미해결 문제로 인해 매크로 브라우저의 새로 고침 기능이 매개변수 수정을 렌더링하지 않는다. 
    현재 페이지 내용이 저장된 후에만 컨텐트 영역 테이블 매크로에 대한 매개변수값 수정 렌더링이 발생한다.
  • HTML 제목 마크 업을 내용 영역 테이블 매크로와 함께 사용 - 내용 영역 테이블 매크로는 HTML 제목 마크 업을 독자적으로 처리할 수 없다. 따라서 HTML 및 HTML Include 매크로를 사용하여 Confluence 페이지에서 HTML 제목 마크 업을 렌더링하는 경우 내용 영역 테이블 매크로는 이러한 제목 중 콘텐츠 목록을 만들지 않는다.(이 문제에 대한 자세한 내용은 TOC-93을 참조.) 

    그러나 다음 구문에 따라 페이지의 각 HTML 제목에 HTML 앵커를 삽입하면 내용 영역 테이블 매크로가 이러한 제목을 콘텐츠 목록에 통합한다.

    <h2><a name="pagename-headingname"></a>Heading Name</h2>

    앵커 이름의 구문은 하이픈으로 구분된 페이지 이름과 제목 이름이다. 모든 공백을 제거하고 모든 텍스트를 소문자로 변환한다. 모든 문장 부호를 URL로 인코딩 된 해당 항목으로 변환한다.