Gallery Macro

Confluence 페이지에 첨부된 이미지를 기반으로 테이블에 미리보기 이미지 모음을 표시. 

페이지를 볼 때 사용자는 축소판 이미지를 클릭하여 화면 크기의 이미지를 확대한 다음 이미지를 슬라이드 쇼로 볼 수 있다.


개요 :

  • 갤러리에 표시된 이미지는 Confluence 페이지에 첨부된 파일에서 가져온다. 첨부 파일이있는 다른 페이지를 지정할 수도 있다.
  • 이미지 아래의 캡션은 첨부 파일의 주석에서 가져온다.
  • 기본적으로 갤러리에는 페이지에 첨부된 모든 이미지가 포함된다. 매개변수를 사용하여 이미지를 제외하거나 포함할 수도 있다.
  • 이미지를 특정 순서로 정렬할 수 있다.
  • 갤러리의 제목을 지정하고 이미지가 표시되는 테이블에 대해 원하는 열의 수를 구성 할 수 있다.

 

Gallery Macro 사용

페이지에 Gallery Macro를 삽입하려면 :

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

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

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

 

매개변수

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

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

다음 표에는 매개변수의 전체 목록이 나와있다. 첨부된 파일 또는 페이지의 이름에 쉼표가 포함되어 있으면 아래의 관련 매개변수에서 작은 따옴표나 큰 따옴표로 묶어서 참조할 수 있다 예) "this,that.jpg", theother.png

 

매개변수

기본값

설명

갤러리 제목 

(title) 

Nothing

갤러리의 제목을 지정

열 개수 

(columns) 

4

테이블의 열 수를 지정

제외할 이미지 

(exclude) 

제외항목 없음

페이지에 모든 그림 포함

갤러리는 지정된 모든 사진을 무시. 쉼표로 구분하여 둘 이상의 그림을 지정할 수 있다. 

노트 :이 매개변수의 파일 이름 및 파일 유형은 대소문자를 구분. 예를 들어, '내 사진.PNG'는 '내 사진.png'로 인식되지 않는다.

이 이미지만

포함 

(include) 

페이지에 모든 그림 포함

특별히 하나 이상의 사진을 포함하면 갤러리에 해당 사진 만 표시. 쉼표로 구분하여 둘 이상의 그림을 지정할 수 있다. 

노트 :이 매개변수의 파일 이름 및 파일 유형은 대소문자를 구분. 예를 들어, '내 사진.PNG'는 '내 사진.png'로 인식되지 않는다.

이 레이블로

이미지 제외 

(excludeLabel) 

제외 항목 없음. 

페이지에 모든 그림 포함

갤러리는 지정된 레이블이 있는 사진을 무시. 쉼표로 구분하여 두 개 이상의 레이블을 지정할 수 있다.

이 레이블이 있는

이미지만 포함 

(includeLabel) 

없음. 

이미지는 레이블 별로 필터링되지 않는다.

레이블 목록을 기반으로 표시할 이미지를 필터링. 두 개 이상의 레이블을 입력하려면 레이블을 쉼표로 구분. 

Confluence는 모든 라벨이 지정된 이미지만 보여준다. 일치 항목은 AND가 아니고 OR이다.

이 페이지의

이미지 사용 

(page) 

페이지를 지정하지 않으면

갤러리 매크로는 매크로가 사용된 페이지에

첨부된 이미지를 표시

표시된 이미지가 포함된 페이지의 제목을 지정. 쉼표로 구분하여 둘 이상의 페이지 이름을 지정할 수 있다. 

다른 공간에 페이지를 지정하려면 다음 구문을 사용.

SPACEKEY:Page Title

이미지

정렬 기준 

(sort) 

없음. 

정렬 순서가 지정되지 않았으므로

예측할 수 없다.

이미지를 정렬할 속성 지정. 역 정렬 매개변수를 선택하지 않으면 정렬 순서가 오름차순이다(아래 참조). 옵션은 다음과 같다.

  • name - 파일 이름
  • comment - 첨부된 파일에 링크된 주석
  • date - 마지막으로 수정된 날짜/시간
  • size - 첨부된 파일의 크기

역순 정렬 

(reverse) 

Off. 정렬 순서가 오름차순

이미지 정렬 기준 매개변수 와 함께 사용. 역순 정렬을 사용하면 오름차순에서 내림차순으로 정렬 순서를 바꿀 수 있다.

저장소 형식 및 wikimarkup에서 사용 가능한 값 :

  • true - 정렬 순서가 내림차순
  • false - 정렬 순서가 오름차순

 

이미지 파일 형식

 

모든 형식의 이미지 파일을 페이지에 첨부할 수 있다. Confluence는 갤러리 매크로와 페이지에 이미지를 표시할 때 다음과 같은 이미지 포맷을 지원한다 :

  • gif

  • jpeg

  • png

  • bmp (브라우저 지원에 따라 다름)

 

위키 마크 업 예제

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

매크로 이름 : gallery

매크로 본문 :  없음

{gallery:title=My holiday pictures|reverse=true|sort=size|page=My page1, ds:Welcome to Confluence|excludeLabel=badlabel1, badlabel2|columns=3|exclude=badpicture.png}