Widget Connector Macro

Owned by 이병욱
2017-09-28
2 min read

온라인 비디오, 슬라이드 쇼, 사진 스트림 등을 페이지에 직접 삽입. 

매크로는 현재 다음 사이트의 콘텐츠를 지원한다.

  • YouTube
  • Vimeo
  • MySpace Video
  • Flickr
  • Twitter
  • Slide Rocket

  • Google Calendar

Widget Connector Macro 사용

Widget Connector Macro를 페이지에 추가하려면 :

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

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

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

 

매개변수

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

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

매개변수

설명

웹 사이트의 위젯 URL(url) 

외부 사이트의 URL. 일부 사이트에서는 브라우저의 주소표시줄에 표시된 URL이 되며 다른 사이트에서는 URL을 가져오기 위해 공유 또는 링크 버튼을 클릭해야할 수도 있다.

픽셀 높이(값만)(height) 

디스플레이의 높이 (픽셀 단위)

픽셀 너비(값만)(width) 

디스플레이의 너비 (픽셀 단위)

 

예제들

모든 사이트는 조금씩 다르므로 각 사이트의 콘텐츠를 페이지에 삽입하기 위해 해야할 일에 대한 정보를 함께 제공한다. 

 

YouTube

YouTube 동영상을 삽입하는 가장 빠른 방법은 URL을 편집기에 붙여넣는 것이다. Confluence는 링크를 자동 변환하고 마술처럼 매크로를 삽입한다. 

Autoconvert는 길고 짧은 YouTube URL로 작동한다.

URL을 위젯 커넥터 매크로 URL 입력란에 수동으로 붙여 넣는 경우 주소표시줄의 긴 URL을 사용해야한다. 

긴 URL은 다음과 유사하다 https://www.youtube.com/watch?v=k6lK5hlB1nQ.

  • 일부 브라우저에서 동영상을 볼 수 없다면 링크에서 http 대신 https를 사용해보시오.
  • 특정 시간에 동영상을 시작하는 매개변수가 포함된 링크는 다음 링크와 같이 위젯 커넥터 매크로에서 자동 변환되거나 작동하지 않는다. 
    짧은 공유 URL에 붙여넣어 작동하는지 확인. https://www.youtube.com/watch?t=15&v=LhHKkodOPFo 

 

Vimeo

Vimeo 비디오를 임베드하는 가장 빠른 방법은 URL을 편집기에 붙여넣는 것이다. Confluence가 링크를 자동 변환하고 매크로를 삽입한다. 

브라우저의 주소표시줄에 있는 URL이나 Vimeo의 공유 버튼을 사용할 수 있다.

 

MySpace Video

비디오를 자동 변환하지 않으므로 먼저 페이지에 Widget Connector 매크로를 추가한 다음 비디오 URL을 URL 필드에 붙여넣어야 한다. 

브라우저의 주소표시줄에 있는 URL이나 MySpace의 공유 옵션을 사용할 수 있다.

 

Flickr

단일 사진, 세트, 전체 사용자의 사진 스트림 또는 특정 태그가 있는 사진 모음을 내장할 수 있다.

가장 빠른 방법은 URL을 편집기에 붙여 넣는 것이다. 이것은 세트와 태그에 적용된다. 다른 URL의 경우 먼저 위젯 커넥터 매크로를 페이지에 추가한 다음 링크를 URL 입력란에 붙여넣는다. 

브라우저의 주소표시줄에있는 URL을 사용.

 

Twitter

단일 트윗을 포함 시키려면 트윗의 세부 정보 링크를 클릭해야만 해당 트윗의 URL을 가져올 수 있다. URL은 다음과 유사하다.  https://twitter.com/atlassian/status/346976521250037760

트윗의 동적 목록을 삽입하려면 먼저 트위터에 위젯을 만들어야 한다.

  1. Twitter에서 설정 및 개인 정보 보호  >  위젯 으로 이동하여 새 위젯을 만든다 (검색).
  2. 검색어에서 해시 태그 또는 프로필 (예 : #atlassian, @atlassian)을 검색할지 선택
  3. 위젯을 만들고 생성된 HTML 코드에서 data-widget-id만 복사(이 예제와 같이 보일 것이다."854765133465255939")
  4. 위젯 커넥터 매크로에 대해 원하는 URL은 다음과 같아야 한다. https://twitter.com/settings/widgets/854765133465255939(슬래시 뒤의 숫자는 달라지므로 Twitter 위젯에서 생성하려는 항목을 변경해야 한다.)
  5. Confluence에서 URL을 위젯 커넥터에 붙여넣기
  6. 아래와 같이 트윗 목록이 표시 


 

SlideRocket

SlideRocket 프리젠테이션을 자동 변환하지 않으므로 먼저 페이지에 위젯 커넥터 매크로를 추가한 다음 비디오 URL을 URL필드에 붙여넣어야 한다. 

SlideRocket 플레이어의 공유 버튼에서 URL을 가져올 수 있다. 

 

Google 캘린더

Google 캘린더를 자동 변환하지 않으므로 먼저 페이지에 위젯 커넥터 매크로를 추가한 다음 캘린더 주소를 URL 입력란에 붙여넣어야 한다. 

공개 캘린더만 임베드할 수 있다. 캘린더 URL을 가져 오려면 Google 캘린더에서 캘린더 설정 > 캘린더 주소로 이동하여 HTML 버튼을 클릭한다. 

URL은 다음과 같다. https://www.google.com/calendar/embed?src=en.australian%23holiday%40group.v.calendar.google.com&ctz=Australia/Sydney

 

문제 해결

위젯 커넥터가 외부 사이트의 콘텐츠를 표시할 수없는 경우 매크로는 다음과 같다.

 

example.com

 

위젯 커넥터 매크로에 콘텐츠를 표시하기 위해 외부 웹 사이트의 API를 사용. API는 때때로 변경되기 때문에 위젯 커넥터 매크로가 콘텐츠 렌더링을 중지시킬 수 있다. 

문제가 발생 하면 문제제기를 통하여 알려주십시오. 

 

위키 마크 업 예제

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

매크로 이름 : widget

매크로 본문 :  없음

{widget:height=400|width=400|url=http://youtube.com/watch?v=23pLByj_q5U}