/
Recently Updated Macro

Recently Updated Macro

Confluence 내에서 가장 최근에 변경된 컨텐츠 목록을 표시

Recently Updated Macro 사용

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

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

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

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

 

매개변수

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

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

매개변수

기본값

설명

작성자(author)

지정한 이름 없음

즉, 모든 콘텐츠를 표시

작성자별로 결과 필터링. 매크로는 여기서 지정한 작성자가 마지막으로 수정한 페이지만 표시한다. 

여러 사용자를 지정할 수 있다.

공간(들)(spaces) 

@self

즉, 매크로가 사용되는

페이지가있는 공간

이 매개변수를 사용하면 공간별로 콘텐츠를 필터링 할 수 있다. 매크로는 여기서 지정한 공간에 속한 페이지만 표시한다

쉼표 또는 공백으로 구분된 하나 이상의 스페이스 키를 지정할 수 있다.

  • 특정 공간의 콘텐츠를 제외하려면 해당 스페이스 키 바로 앞에 빼기 기호(-)를 삽입. 
    예 : -BADSPACE 라는 스페이스 키를 지정하면 BADSPACE에 없는 내용만 가져온다.
  • 특정 공간에서 결과를 가져와야 함을 나타내려면 더하기 기호(+)를 해당 스페이스 키 바로 앞에 삽입
    예 :  +GOODSPACE 라는 스페이스 키를 지정하면 GOODSPACE의 컨텐츠만 가져온다.
    (각 내용 항목이 하나의 공간에만 속하기 때문에 이것은별로 유용하지 않다. 하나의 스페이스 키 옆에 더하기 기호를 추가하고 다른 스페이스 키도 나열하면 다른 스페이스 키는 무시된다.)

 

특별 값 :

  • @self - 현재 공간.
  • @personal - 모든 개인 공간
  • @global - 모든 사이트 공간
  • @favorite - 좋아요를 표시한 공간
  • @favourite - @favorite와 동일
  • @all - Confluence 사이트의 모든 공간
  • * - @all와 동일

개인 공간을 지정할 때는 ~ jbloggs 또는 ~jbloggs@example.com과 같이 사용자 이름 앞에 물결표(~) 기호를 사용해야 한다.

레이블(들)(labels)

지정한 콘텐츠 없음

즉, 모든 콘텐츠 표시

레이블별로 결과를 필터링. 매크로는 여기서 지정한 레이블로 태그가 지정된 페이지만 표시한다

하나 이상의 레이블값을 쉼표 또는 공백으로 구분하여 지정할 수 있다.

  • 주어진 레이블과 일치하는 콘텐츠를 제외하려면 해당 레이블값 바로 앞에 마이너스 기호(-)를 삽입
    예 : -badpage 라는 레이블값을 지정하면 "badpage"로 레이블이 지정되지 않은 콘텐츠만 표시된다.
  • 결과가 지정된 레이블값과 일치해야 함을 나타내려면 해당 레이블값 바로 앞에 더하기 기호(+)를 삽입
    예 :  +superpage,+goodpage 레이블 값을 지정하면 "superpage" 및 "goodpage"라는 레이블이 두 개 이상있는 콘텐츠만 표시된다.

레이블 매개변수는 page및  blog content 유형에만 적용된다.

테이블 너비(width) 

100 %

매크로 너비의 백분율로 매크로 표시의 너비를 지정

이러한 콘텐츠 형식만 포함(types)

모든 유형

이 매개변수를 사용하면 콘텐츠 형식에 따라 콘텐츠를 필터링 할 수 있다. 매크로는 여기서 지정한 유형의 내용만 표시한다

하나 이상의 유형을 쉼표 또는 공백으로 구분하여 지정할 수 있다.

특정 콘텐츠 형식의 콘텐츠를 제외하려면 콘텐츠 형식 바로 앞에 빼기 기호(-)를 삽입

예 : -blogpost 콘텐츠 유형을 지정하면 블로그 게시물을 제외한 페이지 및 기타 모든 콘텐츠가 생성된다.

 

사용 가능한 값 :

  • page - 페이지 
  • blogpost or news - 블로그 게시물(뉴스 항목이라고도 함)
  • comment - 페이지 및 블로그 게시물에 대한 의견
  • attachment - 첨부 파일

최대 결과 수
(max) 

15

표시할 최대 결과 수를 지정. 이 매개 변수를 생략하면 최대 15개의 결과가 표시된다. 

이 매개변수에서 허용할 수있는 이론적인 최대값은 2 31제곱에서 1을 뺀 값(또는 2147483647)이지만, 성능상의 이유로 코드에서 200으로 제한되어 있다.

테마(theme)

concise

이 매크로의 모양을 선택

  • concise - 페이지가 수정되거나 변경된 시간을 기록한 페이지의 이름과 업데이트된 페이지의 이름을 보여주는 기본 목록
  • social - 역순으로 최근 수정 사항을 나열하지만 사용자별로 이를 짧은 시간으로 구분하여 그룹화한다. 
    각 사용자의 시간 구분내에 '하위'목록이 표시되어 업데이트 또는 댓글 달린 페이지의 이름과 이러한 수정이 발생한 시간을 보여준다.
  • sidebar - 최근 업데이트를 시간순으로 역순으로 나열하여 업데이트되거나 주석이 달린 페이지의 이름과 페이지 수정이 발생한 시간을 표시한다. 
    이 테마는 저작자를 표시하지 않는다.

사용자 프로필

사진 표시

(showProfilePic) 

false

 showProfilePic=true 콘텐츠를 업데이트한 사용자의 프로필 사진을 표시하도록 지정

제목 숨기기
(hideHeading) 

false

내용 목록 위의 제목인 'Recently Updated' 텍스트를 숨기거나 표시할지 여부를 결정. wikimarkup 및 저장 형식에서만 사용할 수 있다.

허용되는 값 :

  • true - 제목 숨김
  • false - 제목 표시

 

노트

  • 최근 업데이트 대시 보드 매크로는 이 매크로와 비슷하지만 Confluence 대시 보드에 표시하기 위한 것이다.
  • 최근 업데이트 된 매크로가 표시하는 문구를 변경하려면 Confluence 인터페이스 텍스트 수정에 관한 문서를 참조

 

위키 마크 업 예제

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

매크로 이름 : recently-updated

매크로 본문 :  없음

{recently-updated:spaces=ds|author=admin|max=10|hideHeading=true|width=50%|theme=sidebar|showProfilePic=true|labels=choc|types=page}