Contributors Macro
- 이병욱
페이지에 어떠한 방법이든지 기여를한 Confluence 사용자 리스트를 표시. 페이지의 전문가를 나열하는데 사용할 수도 있다.
이 매크로의 범위를 확장하여 직접적인 하위 또는 지정된 페이지의 하위 항목을 포함할 수 있다. Contributors 목록은 다음과 같은 사람들을 기반으로 할 수 있다.
- 페이지를 작성 또는 편집
- 의견을 게시하거나 페이지에 레이블을 추가
- 단순히 페이지를보고 있음
스크린 샷 : Contributors 목록의 예
이 예에서는 Display Format 매개변수가 list 로 설정됨
Contributors Macro 사용
Contributors Macro를 페이지에 추가하려면 :
- Confluence 편집기에서 삽입> 다른 매크로 선택
- 필요한 매크로 찾기 및 선택
자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.
기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집을 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.
매개변수
매크로 출력의 내용이나 형식을 제어하도록 설정할 수있는 옵션.
Confluence 스토리지 포맷이나 wikimarkup에서 사용되는 매개 변수 이름이 매크로 브라우저에서 사용 된 레이블과 다른 경우, 아래에 대괄호(예)로 표시.
| 매개변수 | 기본값 | 설명 |
|---|---|---|
| 기여 유형(include) | authors | 페이지(및 선택적으로 그 자손 페이지)에 대한 기여 유형 중 하나를 기준으로 필터링. 기여 유형은 다음과 같다.
하나 이상의 기여 유형을 쉼표로 구분하여 지정할 수 있다. |
| 정렬 기준(order) | count | 참여자를 정렬하는 데 사용되는 기준을 지정. 정렬 기준은 다음과 같다.
|
| 역순 정렬(reverse) | false | 목록에있는 사용자의 정렬 순서를 반대로 변경. 정렬 기준 매개변수와 함께 사용 |
최대 참여자 수(limit) | 제한 없음 | 목록에있는 사용자의 수를 제한. 숫자가 지정되지 않으면 모든 참여자가 포함 |
| 표시 형식(mode) | inline | 참여자 이름의 형식을 지정하는 방법 설정
|
| 익명 표시(showAnonymous) | false | 익명으로 페이지에 기여한 사용자를 포함 시킬지 여부 설정 |
| 횟수 표시(showCount) | false | 각 사용자가 지정된 기여 유형으로 기여한 횟수를 표시할지 여부를 설정 |
| 최근시간 표시(showLastTime) | false | 각 사용자가 지정된 기여 유형으로 기여한 마지막 시간을 표시할지 여부를 설정 |
| 페이지 이름(page) | 현재 | 참여자 목록을 생성 할 때 사용할 페이지 지정. 페이지 이름과 공백을 비워두면 현재 페이지가 사용됨 |
| 라벨(labels) | none | 페이지에서 지정된 레이블을 작성한 참여자 목록 필터링. 하나 이상의 레이블을 쉼표로 구분하여 지정할 수 있다. |
| 공간(spaces) | 현재 | 페이지 이름에서 설정한 페이지가 포함 된 Confluence 공간의 스페이스 키를 지정하거나 검색 할 공간을 지정. 스페이스 키는 대소 문자를 구분한다. 이 매개 변수는 다음을 포함하여 특별한 값을 나타낸다.
하나 이상의 스페이스 키 또는 특수 값을 쉼표로 구분하여 지정할 수 있다. 페이지 이름과 라벨을 지정하지 않으면 지정된 공간 세트의 모든 페이지가 포함된다. |
| 콘텐츠 유형(contentType) | 페이지 및 블로그 게시물 모두 | 참여자 목록을 생성 할 때 사용할 콘텐츠 유형을 제한
|
| 블로그 게시물 날짜 (publishDate) | none | 블로그 게시물의 게시 날짜를 지정. 필요한 날짜 형식은 YYYY / MM / DD이다. |
| 페이지 계층 구조 포함 (scope) | 지정된 페이지만 | 참여자 목록을 생성할 때 포함할 추가 페이지를 지정
|
| 선택된 페이지 표시 (showPages) | false | 참여자 목록을 생성하는데 사용된 페이지 목록을 표시할지 여부를 설정 |
| 사용자 정의 "없음"메시지 (noneFoundMessage) | 기본 메시지 | 제공자가 없는 경우 표시되는 기본 메시지를 대체하는데 사용할 메시지를 지정 |
위키 마크 업 예제
이 예제는 편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로) 유용
매크로 이름 : contributors
매크로 본문 : 없음.
이 예는 블로그 게시물의 콘텐츠 유형을 지정
{contributors:limit=10|spaces=ds,@personal|reverse=true|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=blogposts|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|showLastTime=true|publishDate=2012/06/30}
이 예제에서는 페이지의 내용 유형을 지정
{contributors:limit=10|spaces=ds,@personal|reverse=true|scope=descendants|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=pages|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|page=ds:Advanced Topics|showLastTime=true}