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

概要：

  • The images shown in the gallery are taken from the files attached to the Confluence page. You can also specify a different page where the attachments are located. For information about attaching images to a page, see Attaching Files to a Page.
  • The captions below the images are drawn from the comments on the attachments. For information about adding comments to attachments, see Attaching Files to a Page.
  • 既定値では、ページに添付されたすべての画像がギャラリーに表示されます。パラメーターを使用して画像を除外する／取り込むことも可能です。
  • 画像は好みの順番に並べ替えることができます。
  • ギャラリーにタイトルを指定し、画像を表示する表の列数を設定することができます。

On this page:

関連ページ

Screenshot: The Gallery macro as it appears on a page

 

ギャラリー マクロを使用する

ページにギャラリー マクロを挿入するには：

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

To edit an existing macro: Click the macro placeholder and choose Edit. This will display the parameters of the macro in the Macro Browser.

パラメーター

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

パラメーターの完全な一覧は以下の表のとおりです。添付ファイルまたはページの名前にカンマが含まれている場合、それをシングル クォーテーションまたはダブル クォーテーションで囲むと、下記の関連パラメータで参照できます。例: "this,that.jpg", theother.png。

パラメーター

既定

説明

Gallery Title

なし

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

Number of Columns

4

表の列数を指定します。

Images to Exclude

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

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

Include these Images Only

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

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

Exclude Images with these Labels

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

The gallery will ignore any pictures that have the specified label. You can specify more than one label, separated by commas. For information on labelling the attachments, see Adding Labels.
Include Images with these Labels Onlyなし。画像はラベルでフィルタリングされません。Filters the images to display, based on a list of labels. If you wish to enter more than one label, separate the labels with commas. Confluence will show only images that have all the labels specified. (The match is an AND, not an OR.) For information on labelling the attachments, see Adding Labels.

Use Images in these Pages

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

Specify the title of the page which contains the images you want displayed. To specify a page in a different space, use the following syntax: SPACEKEY:Page Title

Sort Images By

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

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

  • name – ファイル名。
  • comment – 添付ファイルにリンクしているコメント。
  • date – 最終の変更日時。
  • size – 添付ファイルのサイズ。

Reverse Sort

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

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

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

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

 

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.