Contributors Summary Macro
페이지 세트에 대하여 기여 기반 통계 테이블을 표시. 이 통계는 개별 페이지 또는 참여자별로 그룹화 할 수 있다.
이 매크로의 기본 범위는 개별 페이지지만 이를 확장하여 지정된 페이지의 직계 하위 또는 하위 항목을 포함 할 수 있다. 통계에는 다음과 같은 유형의 기여가 포함된다.
- 페이지를 편집
- 페이지에 댓글 추가
- 페이지에 추가된 라벨
- 페이지를 보는 사용자(들)
Contributors Summary 매크로의 간단한 예가 아래 스크린 샷에 나와 있다. 여기에는 각 참여자가 편집한 횟수와 댓글 횟수, 라벨링 횟수에 대한 통계가 나열되어 있다.
Screenshot : 예제 제공자 통계 요약 테이블
Contributors Summary Macro 사용
Contributors Summary Macro를 페이지에 추가하려면 :
- Confluence 편집기에서 삽입> 다른 매크로 선택
- 필요한 매크로 찾기 및 선택
자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.
기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집을 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.
매개변수
매크로 출력의 내용이나 형식을 제어하도록 설정할 수있는 옵션.
Confluence 스토리지 포맷이나 wikimarkup에서 사용되는 매개 변수 이름이 매크로 브라우저에서 사용 된 레이블과 다른 경우, 아래에 대괄호(예)로 표시.
매개변수 | 기본값 | 설명 |
---|---|---|
그룹화 기준 | contributors | 기여 기반 통계를 그룹화 하기위한 기초를 지정
|
표시할 열 | edits,comments,labels | 테이블에 표시할 열을 설정. 표시되는 통계 또는 정보 유형은 그룹화 기준 매개변수를 사용하여 집합을 그룹화하는 근거에 따라 다르다. 통계는 다음에 대해 계산될 수 있다.
하나 이상의 열을 사용할 수 있다. |
정렬 기준 | edits | 테이블에 항목을 정렬하는데 사용되는 기준을 설정. 정렬된 항목은 그룹화 기준 매개변수로 설정된 그룹화 기준에 따라 다르다 . 정렬 기준은 다음과 같다.
|
역순 정렬 | false | 정렬 기준 매개변수를 사용하여 지정한 테이블의 항목 정렬 순서를 반대로한다 . 정렬 기준 매개변수 와 함께 사용해야 한다. |
최대 항목 수 | 제한 없음 | 표의 참여자 또는 페이지 수를 지정된 값으로 제한. 숫자를 지정하지 않으면 모든 항목이 포함된다. |
익명 표시 여부 | false | 한 페이지에 익명으로 기고한 개인을 포함 |
0 카운트 표시 | false | 계산된 통계가 0인 참여자 또는 페이지 포함 여부를 설정 |
페이지 이름 | 현재 | 기여 기반 통계를 계산할 페이지를 설정. 페이지 이름 및 공백에 대한 값을 지정하지 않으면 현재 페이지가 사용된다. |
레이블(들) | 없음 | 기여 기반 통계를 지정된 레이블로만 제한. 하나 이상의 레이블을 쉼표로 구분하여 지정할 수 있다. |
공간(들) | 현재 | 지정된 페이지 이름이 포함된 Confluence 공간의 공간 키를 지정하거나 검색할 공간의 범위를 지정. 스페이스 키는 대소 문자를 구분. 이 매개 변수는 다음을 포함하여 특별한 값을가진다.
하나 이상의 스페이스 키 또는 특수 값을 쉼표로 구분하여 지정할 수 있다. 페이지 이름과 레이블을 지정하지 않으면 지정된 공백 세트의 모든 페이지가 포함된다. |
콘텐츠 유형 | 페이지 및 블로그 게시물 모두 | 페이지 유형을 페이지 또는 블로그 게시물 중 하나로 제한. 매크로 브라우저에 값이 지정되어 있지 않으면 페이지와 블로그 게시물이 모두 포함된다. 사용 가능한 값 pages및 blogposts. |
블로그 게시물 날짜 | 없음 | 블로그 게시물의 게시 날짜를 지정. 필요한 날짜 형식은 YYYY / MM / DD이다. |
페이지 계층 구조 포함 | 지정된 페이지만 | 직접 연결된 하위 항목 또는 지정된 페이지의 모든 하위 항목을 포함 . 매크로 브라우저에 값이 표시되지 않으면 지정된 페이지만 포함된다. |
위키 마크 업 예제
이 예제는 편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥글에 사용자 지정 내용으로) 유용
매크로 이름 : contributors-summary
매크로 본문 : 없음.
이 예는 블로그 게시물의 콘텐츠 유형을 지정
{contributors-summary:limit=10|spaces=ds,@personal|reverse=true|showAnonymous=true|order=update|labels=chocolate,cake|columns=edits,comments,labels,lastupdate|groupby=pages|contentType=blogposts|showZeroCounts=true|publishDate=2012/06/07}
이 예는 페이지의 내용 유형을 지정
{contributors-summary:limit=10|spaces=ds,@personal|reverse=true|showAnonymous=true|scope=descendants|order=update|page=ds:Advanced Topics|labels=chocolate,cake|columns=edits,comments,labels,lastupdate|groupby=pages|contentType=pages|showZeroCounts=true}