Excerpt Macro
재사용을 위해 페이지 내용의 일부를 표시하는데 사용된다. 발췌 부분을 정의하면 Excerpt Include macro 및 Blog Posts macro와 같은 매크로가 다른 곳에서 내용을 표시할 수 있다.
페이지 당 하나의 발췌 부분만 정의할 수 있다. 즉, Excerpt 매크로는 한번만 페이지에 추가할 수 있다.
Excerpt Macro 사용
Excerpt Macro를 페이지에 추가하려면 :
- Confluence 편집기에서 삽입 > 다른 매크로 선택
- 필요한 매크로 찾기 및 선택
자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.
기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집 선택 . 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.
매크로에 재사용 가능한 콘텐츠를 추가하려면 :
- Excerpt 매크로 플레이스 홀더에 콘텐츠를 추가
- 매크로 자리 표시자를 선택하여 옵션 패널이 나타나면 새 행에 표시 또는 인라인 표시에 대한 옵션 선택. 기본값은 새 행에 매크로의 내용을 표시하는 것이다.
인라인 옵션을 선택하면 매크로의 내용이 앞뒤에 있는 텍스트와 같은 단락의 일부가 된다. 이 옵션은 Excerpt 매크로가 포함된 페이지에만 영향을 준다. 콘텐츠가 재사용되는 페이지에는 영향을 주지 않는다.
스크린 샷 : Excerpt 매크로 자리 표시 자 및 옵션 패널
- 새 행
- 인라인
매개 변수
매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션.
Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개변수 이름이 매크로 브라우저에서 사용된 레이블과 다른 경우, 아래에 대괄호 ( example
) 로 표시된다.
매개 변수 | 기본값 | 설명 |
---|---|---|
발췌 내용 숨기기 | 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}