ウィジェット コネクタ マクロ
ウィジェット コネクター マクロを使用して、オンライン ビデオ、スライドショー、写真ストリームをページに直接埋め込みます。
マクロは現在、これらのサイトのコンテンツをサポートしています。
- YouTube
- Vimeo
- MySpace ビデオ
- Flickr
- Slide Rocket
Google カレンダー
ウィジェット コネクタの使用
ウィジェット コネクタをページに追加する方法
- From the editor toolbar, choose (Insert) > Other Macros
- 対象のマクロを見つけて、選択します。
Speed it up with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. In this example we're inserting the cheese macro.
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
On this page:
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
パラメーター | 説明 |
---|---|
Web サイトのウィジェット URL | これは、外部サイトの URL です。一部のサイトでは、ブラウザのアドレス バーに表示される URL です。他のサイトでは、[共有] または [リンク] ボタンをクリックして URL を取得する必要が出る場合があります。 |
ピクセルの高さ (値のみ) | ディスプレイの高さ (ピクセル単位) |
ピクセル幅 (値のみ) | ピクセル単位で示されるディスプレイの幅。 |
例
すべてのサイトは他のサイトとは少し異なりますので、各サイトのコンテンツをページに埋め込むために必要な情報をまとめました。
YouTube
YouTube ビデオを埋め込む最も速い方法は、エディターに URL を貼り付けることです。Confluence はリンクを自動変換し、マクロを挿入します。 自動変換は YouTube URL が長くても短くても機能します。
ウィジェット コネクタ マクロの URL フィールドに手動で URL を貼り付ける場合、アドレス バーに表示された長い URL を使用する必要があります。長い URL は次のようになります: https://www.youtube.com/watch?v=k6lK5hlB1nQ
- 同じブラウザでビデオを表示できない場合は、リンクに http ではなく https を使用してください。
- 特定の時間にビデオを開始するパラメーターを含むリンクは、ウィジェット コネクタ マクロで自動変換されず、動作もしません (例:
https://www.youtube.com/watch?t=15&v=LhHKkodOPFo
)。動作させるようにするには、短い共有 URL として貼り付けます。
Vimeo
Vimeoe ビデオを埋め込む最も速い方法は、エディターに URL を貼り付けることです。Confluence はリンクを自動変換し、マクロを挿入します。
ブラウザのアドレス バーから URL を入力するか、Vimeo の 共有 ボタンを使用できます。
MySpace ビデオ
MySpace ビデオは自動変換されないため、ページにウィジェット コネクタ マクロを追加してから、ビデオの URL を URL フィールドに貼り付ける必要があります。
ブラウザのアドレス バーから URL を入力するか、MySpace の 共有 オプション を使用できます。
Flickr
1 つの写真、セット、またはユーザーのフォトストリームや特定のタグが付いた写真のコレクションを埋め込むことができます。
Vimeoe ビデオを埋め込む最も速い方法は、エディターに URL を貼り付けることです。この操作は、セットやタグで機能します。他の URL については、ウィジェット コネクタ マクロをまずページに追加してから、リンクを URL フィールドに貼り付ける必要があります。
ブラウザのアドレス バーで URL を使用します。
1 つのツイートを埋め込むには、ツイートの [ツイートへのリンクをコピーする] をクリックします。URL は次のようになります: https://twitter.com/atlassian/status/346976521250037760
Twitter でウィジェットの動作が変更されたため、現在、ツイートのリストを埋め込むことはできません。
ツイートのリストを表示するための回避策として、HTML Macro を有効化してから、https://publish.twitter.com/ を使用して埋め込みコードを生成します。
SlideRocket
SlideRocket プレゼンテーションは自動変換されないため、ページにウィジェット コネクタ マクロを追加してから、ビデオの URL を URL フィールドに貼り付ける必要があります。
SlideRocket プレーヤーの 共有 ボタンから URL を取得できます。
Google カレンダー
Google カレンダーは自動変換されないため、ページにウィジェット コネクタ マクロを追加してから、カレンダー アドレスを URL フィールドに貼り付ける必要があります。
パブリックカレンダーのみを埋め込むことができます。カレンダーの URL を取得するには、Google Calendar で カレンダー設定 > カレンダー アドレスに移動し、HTML ボタンをクリックします。
URL は次のようになります: https://www.google.com/calendar/embed?src=en.australian%23holiday%40group.v.calendar.google.com&ctz=Australia/Sydney
トラブルシューティング
ウィジェット コネクタが外部サイトのコンテンツを表示できない場合、マクロは次のようになります。
外部 Web サイトの API に依存し、ウィジェット コネクタ マクロのコンテンツを表示しています。API は時折変更されます。これによりウィジェット コネクタ マクロがコンテンツのレンダリングを停止する場合があります。
問題が発生した場合は、そのことに関する課題を作成することができます。
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: widget
マクロ本文: なし。
{widget:height=400|width=400|url=http://youtube.com/watch?v=23pLByj_q5U}