Gallery Macro
Confluence 페이지에 첨부된 이미지를 기반으로 테이블에 미리보기 이미지 모음을 표시.
페이지를 볼 때 사용자는 축소판 이미지를 클릭하여 화면 크기의 이미지를 확대한 다음 이미지를 슬라이드 쇼로 볼 수 있다.
개요 :
- 갤러리에 표시된 이미지는 Confluence 페이지에 첨부된 파일에서 가져온다. 첨부 파일이있는 다른 페이지를 지정할 수도 있다.
- 이미지 아래의 캡션은 첨부 파일의 주석에서 가져온다.
- 기본적으로 갤러리에는 페이지에 첨부된 모든 이미지가 포함된다. 매개변수를 사용하여 이미지를 제외하거나 포함할 수도 있다.
- 이미지를 특정 순서로 정렬할 수 있다.
- 갤러리의 제목을 지정하고 이미지가 표시되는 테이블에 대해 원하는 열의 수를 구성 할 수 있다.
Gallery Macro 사용
페이지에 Gallery Macro를 삽입하려면 :
- Confluence 편집기에서 삽입 > 다른 매크로 선택
- 필요한 매크로 찾기 및 선택
자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.
기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.
매개변수
매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션.
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) | 없음. 정렬 순서가 지정되지 않았으므로 예측할 수 없다. | 이미지를 정렬할 속성 지정. 역 정렬 매개변수를 선택하지 않으면 정렬 순서가 오름차순이다(아래 참조). 옵션은 다음과 같다.
|
역순 정렬 (reverse) | Off. 정렬 순서가 오름차순 | 이미지 정렬 기준 매개변수 와 함께 사용. 역순 정렬을 사용하면 오름차순에서 내림차순으로 정렬 순서를 바꿀 수 있다. 저장소 형식 및 wikimarkup에서 사용 가능한 값 :
|
이미지 파일 형식
모든 형식의 이미지 파일을 페이지에 첨부할 수 있다. 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}