ウィジェット コネクタ マクロ
ウィジェット コネクター マクロを使用して、オンライン ビデオ、スライドショー、写真ストリームをページに直接埋め込みます。
マクロは現在、これらのサイトのコンテンツをサポートしています。
- YouTube
- Vimeo
- MySpace ビデオ
- Flickr
- Slide Rocket
Google カレンダー
ウィジェット コネクタの使用
ウィジェット コネクタをページに追加する方法
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化： タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
On this page:
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。
パラメーター | 説明 |
|---|---|
Web サイトのウィジェット URL | これは、外部サイトの URL です。一部のサイトでは、ブラウザのアドレス バーに表示される URL です。他のサイトでは、[共有] または [リンク] ボタンをクリックして URL を取得する必要が出る場合があります。 |
ピクセルの高さ (値のみ) | ディスプレイの高さ (ピクセル単位) |
ピクセル幅 (値のみ) | ピクセル単位で示されるディスプレイの幅。 |
例
すべてのサイトは他のサイトとは少し異なりますので、各サイトのコンテンツをページに埋め込むために必要な情報をまとめました。
YouTube
The fastest way to embed a YouTube video is to paste the URL into the editor. Confluence will autoconvert the link and insert the macro for you, like magic. Autoconvert works with both long and short YouTube URLs.
ウィジェット コネクタ マクロの 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 を使用します。
We don't autoconvert Twitter, so you'll need to add the Widget Connector macro to your page first, and then paste the URL into the URL field.
To embed a single tweet you'll need to click the Details link on the tweet so you can grab the URL for just that tweet. The URL will look something like https://twitter.com/atlassian/status/346976521250037760.
ツイートの動的なリストを埋め込むには、最初に Twitter でウィジェットを作成する必要があります。
- In Twitter, go to Settings > Widgets and create a widget to display the tweets you want to embed (for example, a user timeline, list of tweets or hashtag search).
- Save the widget, then copy the page URL. The URL should look something like this
https://twitter.com/settings/widgets/354381809263472640(without/editon the end). - Confluence で、ウィジェット コネクタに URL を貼り付けます。
- ツィートのリストが以下のように表示されます。
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 は時折変更されます。これによりウィジェット コネクタ マクロがコンテンツのレンダリングを停止する場合があります。
問題が発生した場合は、そのことに関する課題を作成することができます。
コードの例
次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。
マクロ名: widget
マクロ本文: なし。
保存形式の例
<ac:structured-macro ac:name="widget">
<ac:parameter ac:name="height">480</ac:parameter>
<ac:parameter ac:name="width">640</ac:parameter>
<ac:parameter ac:name="url">
<ri:url ri:value="http://youtube.com/watch?v=23pLByj_q5U"/>
</ac:parameter>
</ac:structured-macro>