Excerpt Macro

재사용을 위해 페이지 내용의 일부를 표시하는데 사용된다. 발췌 부분을 정의하면 Excerpt Include macro 및 Blog Posts macro와 같은 매크로가 다른 곳에서 내용을 표시할 수 있다.

페이지 당 하나의 발췌 부분만 정의할 수 있다. 즉, Excerpt 매크로는 한번만 페이지에 추가할 수 있다.

Excerpt Macro 사용

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

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

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

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

 

매크로에 재사용 가능한 콘텐츠를 추가하려면 :

  1. Excerpt 매크로 플레이스 홀더에 콘텐츠를 추가
  2. 매크로 자리 표시자를 선택하여 옵션 패널이 나타나면 새 행에 표시 또는 인라인 표시에 대한 옵션 선택. 기본값은 새 행에 매크로의 내용을 표시하는 것이다. 
    인라인 옵션을 선택하면 매크로의 내용이 앞뒤에 있는 텍스트와 같은 단락의 일부가 된다. 이 옵션은 Excerpt 매크로가 포함된 페이지에만 영향을 준다. 콘텐츠가 재사용되는 페이지에는 영향을 주지 않는다.

스크린 샷 : Excerpt 매크로 자리 표시 자 및 옵션 패널

  1. 새 행
  2. 인라인

매개 변수

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

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

 

매개 변수

기본값

설명

발췌 내용 숨기기 
(hidden

false

Excerpt 매크로 개체 틀에 포함된 페이지 콘텐츠가 페이지에 표시되는지 여부를 제어.

이 옵션은 Excerpt 매크로가 포함된 페이지에만 영향을 준다. 콘텐츠가 재사용되는 페이지에는 영향을주지 않는다.

 

 

위키 마크 업 예제

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

매크로 이름 : excerpt

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

{excerpt:hidden=true|atlassian-macro-output-type=BLOCK}
This is the *text* I want to reuse in other pages. This text is inside an Excerpt macro.
{excerpt}