ギャラリー マクロを挿入する

このマクロは新しいエディタから意図的に除外されており、従来のエディタから近日中に廃止されます。

ギャラリー マクロは、Confluence ページに添付された画像に基づき、サムネイル画像のコレクションを表形式で表示します。ページの閲覧中、ユーザーはサムネイル画像をクリックして拡大し、スクリーンサイズのスライドショーとして見ることができます。

概要:

  • ギャラリーに表示される画像は、Confluence ページに添付されたファイルから取り込まれます。また、ファイルが添付されている他のページを指定できます。ページに画像を添付する方法については「ファイルをアップロードする」をご参照ください。

  • 画像の下部のキャプションは、添付ファイルのコメントから取り込まれます。添付ファイルにコメントを追加する方法については「ファイルをアップロードする」をご参照ください。

  • 規定値では、ページに添付されたすべての画像がギャラリーに表示されます。パラメーターを使用して画像を除外する/取り込むことも可能です。

  • 画像は好みの順番に並べ替えることができます。

  • ギャラリーにタイトルを指定し、画像を表示する表の列数を設定することができます。

ギャラリー マクロを追加するには、次の手順に従います。

  1. 編集時には、ツールバーから を選択します。

  2. 挿入するアイテムを探して選択します

  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。

ギャラリー マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。

  2. 編集を選択します。右側のパネルが開きます。

  3. パラメータを修正します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します ()。

パラメーターの完全なリストは、次の表のとおりです。添付ファイル名またはページ名にカンマが含まれている場合は、一重または二重の各引用符で括ることで、下記の関連パラメーターで参照できます (例: "this,that.jpg", theother.png)。

パラメーター

既定

説明

Gallery Title
(title

なし

ギャラリーのタイトルを指定します。

Number of Columns
(columns

4

表の列数を指定します。

Images to Exclude
(exclude

除外なし。ページのすべての写真を含める。

ギャラリーは指定した写真を無視します。複数の写真をカンマ区切りで指定できます。
注意:このパラメーターのファイル名とファイルタイプは大文字小文字を区別します。例えば、 'my picture.PNG' は 'my picture.png' として認識されません。

Include these Images Only
(include

ページのすべての写真を含める

1 つ以上の画像を指定して含めると、その画像のみがギャラリーに表示されます。カンマ区切りで複数の画像を指定できます。

このパラメーターのファイル名とファイルタイプは、大文字と小文字を区別します。たとえば、'my picture.PNG' は 'my picture.png' として認識されません。

Exclude Images with these Labels
(excludeLabel

除外なし。ページのすべての写真を含める。

ギャラリーは指定したラベルが付いている画像を無視します。カンマ区切りで複数のラベルを指定できます。添付ファイルにラベルを付ける方法については「ラベルを使用してページと添付ファイルを整理する」をご参照ください。

Include Images with these Labels Only
(includeLabel

なし。画像はラベルでフィルタリングされません。

ラベル リストに基づいて、表示する画像をフィルタリングします。カンマ区切りで複数のラベルを区切ります。Confluence は、指定した 1 つ以上のラベルを持つ画像を表示します (AND の反対である OR)。

添付ファイルにラベルを付ける方法については「ラベルを使用してページと添付ファイルを整理する」をご参照ください。

Use Images in these Pages
(page

ページが指定されていない場合、ギャラリー マクロはマクロが使用されているページに添付された画像を表示します。

表示する画像を含むタイトルを指定します。カンマ区切りで複数のページを指定できます。異なるスペースのページを指定するには、次の構文を使用します。SPACEKEY:Page Title

Sort Images By
(sort

なし。並べ替え順が指定されていないため、順不同。

画像を並べ替える属性を指定します。並べ替え順は降順パラメーターを選択していない限り、 昇順です(以下参照)。オプションは以下のとおりです。

  • name – ファイル名。

  • comment – 添付ファイルにリンクしているコメント。

  • date – 最終の変更日時。

  • size – 添付ファイルのサイズ。

Reverse Sort
(reverse

オフ。並べ替え順は昇順。

上記のSort Images Byパラメーターと組み合わせて使用します。Reverse Sort により、並べ替え順を昇順から降順に変更します。

保存形式と Wiki マークアップで使用可能な値:

  • true – 降順で並べ替え。

  • false – 昇順で並べ替え。

画像ファイル フォーマット

ページにはあらゆるフォーマットの画像ファイルを添付できます。Confluence がギャラリーマクロでの使用とページでの表示でサポートする画像フォーマットは以下のとおりです。

  • gif

  • jpeg

  • png

  • bmp (ブラウザのサポートによる)

Wiki マークアップの例

Wiki マークアップは従来のエディタでのみサポートされます。

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

Macro name: gallery

マクロ本文: なし。

1 2 3 4 {gallery:title=My holiday pictures|reverse=true|sort=size|page=My page1, ds:Welcome to Confluence|excludeLabel=badlabel1, badlabel2|columns=3|exclude=badpicture.png}

 

その他のヘルプ