Gadget Macro

가젯은 동적 콘텐츠를 제공할 수 있는 소규모 애플리케이션이다. 일반적으로 웹 응용 프로그램 서버에서 제공되며 다른 많은 웹 응용 프로그램에서 다시 사용할 수 있다. 

Confluence에는 페이지 또는 블로그 게시물에 추가할 수 있는 몇 가지 자체 가젯이 번들로 제공된다 . 

Confluence 관리자가 다음과 같은 경우에 이 목록에서 추가 가젯에 접근할 수 있다 :

• Confluence에 추가 가젯을 설치 (일반적으로 Confluence 플러그인으로 사용)
• 외부 웹 애플리케이션 또는 웹 사이트에서 제공되는 등록된 가젯 (JIRA 애플리케이션의 가젯 등)

다른 매크로와 달리 각 Gadget 매크로의 이름은 고유하며 "<가젯 이름> 매크로" 규칙을 따른다. 여기서 <가젯 이름> 은 가젯 자체에서 제공한 이름이다.

Confluence 페이지나 블로그 포스트에 가젯 삽입하기

페이지에 가젯을 추가하려면 :

1. 페이지 또는 블로그 게시물을 편집
2.  삽입 > 기타 매크로 선택
3.  외부 콘텐츠 클릭하여 Confluence 설치에 사용하도록 구성된 가젯 목록 확인
   JIRA Issues ,  RSS Feed , Widget Connector 매크로 같은 일부 Confluence 매크로는 외부 컨텐트에 액세스할 수도 있기 때문에 이 범주에도 나타난다.      
4. 원하는 가젯을 클릭하여 매개변수와 속성에 액세스. 거의 모든 가젯을 사용하면 매크로 대화 상자에 나타나는 기본 매개변수를 설정할 수 있다 . 
   일부 가젯에는 자체 가젯 세트만 설정할 수 있는 매개변수 세트가 있다. 매크로 브라우저에서 미리보기를 사용하여 매크로 브라우저에 액세스 할 수 있다.
5. 매개변수를 요구 사항에 설정
6. 변경 사항을 미리 보려면 새로 고침을 클릭
7.  삽입을 클릭 하여 페이지에 가젯을 추가

Confluence 페이지 또는 블로그 게시물에서 가젯 수정하기

페이지 또는 블로그 게시물에서 기존 가젯을 편집하려면 :

1. 페이지 또는 블로그 게시물을 편집
2. 가젯 매크로 자리 표시자를 클릭하고 편집 선택하거나 자리 표시자를 두번 클릭
3. 가젯의 매개변수를 요구 사항에 설정
4. 변경 사항을 미리 보려면 새로 고침을 클릭
5. 가젯을 저장

표준 가젯 매개 변수

거의 모든 가젯은 매크로 대화 상자의 오른쪽에 나타나는 기본 매개변수를 설정할 수 있다 . 

각 가젯에는 매크로 대화 상자의 왼쪽에 나타나는 매개변수 집합이 있을 수도 있다.

가젯 매크로의 내용

표준 매개변수 외에도 가젯 매크로에는 각 가젯에 특정한 속성 설정을 나타내는 '매개변수 유사 콘텐츠'가 포함되어 있다. 따라서 이곳에 따로 문서화되어 있지는 않다. 

일반적으로 이 내용은 매크로 브라우저를 사용하여 가젯의 기본 속성을 사용자 지정하여 변경할 수 있다.

위키 마크 업 예제

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

매크로 이름 : gadget

매크로 본문 :  없음

Confluence Page 가젯 :

{gadget:width=500|border=false|url=rest/gadgets/1.0/g/com.atlassian.confluence.plugins.gadgets:confluence-page-gadget/gadgets/confluence-page-gadget.xml} spaceName=Documentation&spaceKey=DOC&quickfind-space=Documentation&pageId=753666&pageName=Documentation%20Home&quickfind-page=Documentation%20Home&isEditable=true&isConfigured=true&refresh=15&showLink=false {gadget}

Confluence News 가젯 :

{gadget:url=rest/gadgets/1.0/g/com.atlassian.confluence.plugins.gadgets:confluence-news-gadget/gadgets/confluence-news-gadget.xml} {gadget}