/
Blog Posts Macro

Blog Posts Macro

Confluence 페이지에 블로그 게시물을 표시 할 수 있게 한다.
제목을 클릭하면 블로그 게시물로 이동.

 

블로그 게시물 매크로 사용
블로그 게시물 매크로를 페이지에 추가하려면,

  1. Confluence 에디터에서 Insert> Other Macros 선택
  2. 필요한 매크로 찾기 및 선택

자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분 입력
기존 매크로 편집하기 : 매크로 자리 표시자를 클릭하고 편집 선택. 매크로 대화 상자 창이 열리고 매크로 매개 변수 편집 가능

 

매개 변수
매크로 출력의 내용이나 형식을 제어하도록 설정할 수있는 옵션.
Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개 변수 이름이 매크로 브라우저에서 사용되는 라벨과 다른 경우, 아래에 대괄호 (예)로 표시

ParameterRequiredDefaultDescription
표시할 내용유형(content)No

titles

사용가능한 값 :

  • titles - 각 블로그 게시물의 제목, 작성자, 공백 및 만든 날짜 스탬프 표시
  • excerpts - 각 블로그 게시물에서 짧은 발췌 내용을 표시.
    게시물에 Excerpt 매크로가 포함되어있는 경우 Blog Posts 매크로는 Excerpt 매크로에 정의된 내용 표시
    게시물에 Excerpt 매크로가 없으면 블로그 게시물 매크로는 게시물의 처음 몇 문장 표시
  • entire - 각 블로그 게시물의 전체 내용을 표시
시간 프레임(time)No

no limit

사용 가능한 값 :

  • m - 분
  • h - 시간. '12시간'은 지난 12시간 동안 작성된 블로그 게시물을 표시
  • d - 일. '7d'는 지난 7일 동안 작성된 블로그 게시물을 표시
  • w - 주
이 라벨로 제한(label)No

None

라벨별로 결과를 필터링. 여기서 지정한 라벨로 태그가 지정된 블로그 게시물만 표시
하나 이상의 라벨값을 쉼표 또는 공백으로 구분하여 지정 가능

  • 주어진 라벨과 일치하는 콘텐츠를 제외하려면 해당 라벨값 바로 앞에 빼기 기호(-) 입력
    예: 라벨 값으로 -badpage를 지정하면 'badpage'로 라벨이 지정되지 않은 콘텐츠만 표시
  • 결과가 지정된 라벨값과 일치해야 함을 나타내려면 해당 라벨값 바로 앞에 더하기 기호(+) 입력
    예: +superpage, +goodpage라는 라벨값을 지정하면 'superpage'및 'goodpage'라는 라벨이 2개 이상 있는 콘텐츠만 표시
이 저자에게만 제한(author)No

None

작성자별로 결과 필터링. 여기에서 지정한 작성자가 작성한 블로그 게시물만 표시
이 스페이스로 제한(spaces)No

@self, 매크로가 코딩된 페이지가 있는 공간

공간별로 콘텐츠 필터링 가능. 여기서 지정한 공간에 속한 페이지만 표시
쉼표 또는 공백으로 구분된 하나 이상의 공간키를 지정할 수 있다.

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

특별값:

  • @self - 현재 공간
  • @personal - 모든 개인 공간
  • @global - 모든 사이트 공간
  • @favorite - 즐겨찾기로 표시된 공간
  • @favourite - @favorite와 동일
  • @all - Confluence 사이트의 모든 공간
  • * - @all과 동일

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

최대 블로그 게시물 수(max)No

15

표시할 최대 결과 수 지정. 결과는 먼저 정렬된 다음 최대 매개 변수가 적용
정렬 기준(sort)No

creation

결과 정렬하는 방법 지정. 이 매개변수가 지정되지 않으면 정렬 순서는 생성 날짜를 기준으로 내림차순(가장 새로운 것부터)으로 기본 설정.
값 :

  • title - 제목순으로 알파벳순으로 정렬
  • creation - 내용이 추가된 날짜별로 정렬
  • modified - 내용이 마지막으로 업데이트 된 날짜순으로 정렬
역순 정렬(reverse)No

false

내림차순에서 오름차순으로 정렬을 변경하려면 선택(가장 오래된 것부터). 정렬 기준 매개변수와 함께 사용. 정렬 기준 매개 변수가 지정되지 않은 경우 무시.
저장소 형식과 wikimarkup에서 true 값은 정렬 순서를 변경

 

위키 마크 업 예제
이 예제는 편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로 유용 할 때 유용합니다.
매크로 이름 : blog-posts
매크로 본문 : 없음

{blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookies}