Contributors Summary Macro

페이지 세트에 대하여 기여 기반 통계 테이블을 표시. 이 통계는 개별 페이지 또는 참여자별로 그룹화 할 수 있다.

이 매크로의 기본 범위는 개별 페이지지만 이를 확장하여 지정된 페이지의 직계 하위 또는 하위 항목을 포함 할 수 있다. 통계에는 다음과 같은 유형의 기여가 포함된다.

  • 페이지를 편집
  • 페이지에 댓글 추가
  • 페이지에 추가된 라벨
  • 페이지를 보는 사용자(들)

Contributors Summary 매크로의 간단한 예가 아래 스크린 샷에 나와 있다. 여기에는 각 참여자가 편집한 횟수와 댓글 횟수, 라벨링 횟수에 대한 통계가 나열되어 있다.

Screenshot : 예제 제공자 통계 요약 테이블

 

Contributors Summary Macro 사용

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

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

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

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

 

매개변수

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

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

매개변수

기본값

설명

그룹화 기준 
(groupby)

contributors

기여 기반 통계를 그룹화 하기위한 기초를 지정

  • contributors - 기여한 사람들의 그룹
  • pages - 참여자를 찾는데 사용된 페이지별로 그룹화

표시할 열 
(columns)

edits,comments,labels

테이블에 표시할 열을 설정. 표시되는 통계 또는 정보 유형은 그룹화 기준 매개변수를 사용하여 집합을 그룹화하는 근거에 따라 다르다.

 통계는 다음에 대해 계산될 수 있다.

  • edits - 각 참여자가 페이지를 편집한 횟수 또는 각 페이지에 수행된 편집 횟수
  • edited - 각 참여자가 편집한 페이지 목록 또는 각 페이지를 편집한 참여자 목록
  • comments - 각 참여자가 페이지에 주석을 추가한 횟수 또는 각 페이지의 주석 수
  • commented - 각 참여자가 주석을 추가한 페이지 목록 또는 각 페이지에 주석을 추가한 참여자 목록
  • labels - 각 참여자가 페이지에 레이블을 추가한 횟수 또는 각 페이지의 레이블 수
  • labeled - 각 참여자가 레이블을 추가한 페이지 목록 또는 각 페이지에 레이블을 추가한 참여자 목록
  • labellist - 각 참여자 또는 각 페이지에 추가된 레이블 목록
  • watches - 각 참여자/사람이 보는 페이지 수 또는 각 페이지를 보는 참여자 수/사람들 수
  • watching - 각 참여자/사람이 보는 페이지 목록 또는 각 페이지를 보는 참여자/사람들 목록
  • lastupdate- 각 참여자가 마지막으로 업데이트하거나 각 페이지가 마지막으로 업데이트된 시간. 
    유효한 업데이트에는 페이지 편집, 주석 또는 레이블 수정이 포함될 수 있다. 

하나 이상의 열을 사용할 수 있다.

정렬 기준 
(order) 

edits

테이블에 항목을 정렬하는데 사용되는 기준을 설정. 정렬된 항목은 그룹화 기준 매개변수로 설정된 그룹화 기준에 따라 다르다 . 정렬 기준은 다음과 같다.

  • edits - 참여자 또는 페이지에 의해 수행된 편집의 총 수를 기반으로 테이블의 항목을 정렬
  • name - 테이블의 항목을 참여자 또는 페이지 이름별로 사전 순으로 정렬
  • editTime - 참여자가 마지막으로 페이지 (또는 지정된 페이지 세트)를 편집한 시기 또는 페이지를 계속 편집한 시점을 기준으로 표의 항목을 정렬
  • update - 참여자가 마지막으로 페이지 (또는 지정된 페이지 세트)에 기여한 시기 또는 페이지에 마지막으로 기여한 부분을 기반으로 표의 항목을 정렬

역순 정렬 
(reverse) 

false

 정렬 기준 매개변수를 사용하여 지정한 테이블의 항목 정렬 순서를 반대로한다 . 정렬 기준 매개변수 와 함께 사용해야 한다.

최대 항목 수 
(limit) 

제한 없음

표의 참여자 또는 페이지 수를 지정된 값으로 제한. 숫자를 지정하지 않으면 모든 항목이 포함된다.

익명 표시 여부
(showAnonymous) 

false

한 페이지에 익명으로 기고한 개인을 포함

0 카운트 표시
(showZeroCounts )

false

계산된 통계가 0인 참여자 또는 페이지 포함 여부를 설정

페이지 이름 
(page) 

현재

기여 기반 통계를 계산할 페이지를 설정. 페이지 이름 및 공백에 대한 값을 지정하지 않으면 현재 페이지가 사용된다.

레이블(들) 
(labels) 

없음

기여 기반 통계를 지정된 레이블로만 제한. 하나 이상의 레이블을 쉼표로 구분하여 지정할 수 있다.

공간(들) 
(spaces) 

현재

지정된 페이지 이름이 포함된 Confluence 공간의 공간 키를 지정하거나 검색할 공간의 범위를 지정. 

스페이스 키는 대소 문자를 구분. 이 매개 변수는 다음을 포함하여 특별한 값을가진다.

  • @global - 모든 사이트 공간
  • @personal - 모든 개인 공간
  • @all - Confluence 사이트의 모든 공간

하나 이상의 스페이스 키 또는 특수 값을 쉼표로 구분하여 지정할 수 있다. 

페이지 이름과 레이블을 지정하지 않으면 지정된 공백 세트의 모든 페이지가 포함된다.    

콘텐츠 유형 
(contentType) 

페이지 및 블로그 게시물 모두

페이지 유형을 페이지 또는 블로그 게시물 중 하나로 제한. 매크로 브라우저에 값이 지정되어 있지 않으면 페이지와 블로그 게시물이 모두 포함된다.

사용 가능한 값 pages및 blogposts.

블로그 게시물 날짜 
(publishDate) 

없음

블로그 게시물의 게시 날짜를 지정. 필요한 날짜 형식은 YYYY / MM / DD이다.

페이지 계층 구조 포함 
(scope) 

지정된 페이지만

직접 연결된 하위 항목 또는 지정된 페이지의 모든 하위 항목을 포함 . 매크로 브라우저에 값이 표시되지 않으면 지정된 페이지만 포함된다.

 

위키 마크 업 예제

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

매크로 이름 : 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}