The Gallery Macro displays a gallery of thumbnail images in a table, based on the images attached to a Confluence page. When viewing the page, a user can click a thumbnail image to zoom into the full-size image and then view the images as a slide show.

See below for instructions on how to add the gallery macro to your page.

The gallery macro appears as in the screenshot below.

 

On this page:

Screenshot: The Gallery Macro in Confluence

 

Using the Gallery Macro

To insert the Gallery macro into 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

No exclusions i.e. include all the pictures on the page.

The gallery will ignore any pictures specified. You can specify more than one picture, separated by commas.
Please note, the filename and filetype for this parameter are case-sensitive, i.e. 'my picture.PNG' will not be recognised as 'my picture.png'.

Include these Images Only

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

If you specifically include one or more pictures, the gallery will show only those pictures. You can specify more than one picture, separated by commas.
Please note, the filename and filetype for this parameter are case-sensitive, i.e. 'my picture.PNG' will not be recognised as 'my picture.png'.

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 SPACEKEY:Page Title syntax.

Sort Images By

None, i.e. the sort order is unspecified and therefore unpredictable.

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

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

Reverse Sort

Off, i.e. sort order is ascending

Used in conjunction with the Sort Images By parameter above. Use Reverse Sort to reverse the sort order, from ascending to descending.

Considerations for using the gallery macro

  • 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 comments below the images are drawn from the comments on the attachments. For information about adding comments to attachments, see Attaching Files to a Page.
  • 既定値では、ページに添付されたすべての画像がギャラリーに表示されます。パラメーターを使用して画像を除外する／取り込むことも可能です。
  • Only the following file formats are supported: gif, png, jpeg. The bmp format is not supported.
  • 画像は好みの順番に並べ替えることができます。
  • ギャラリーにタイトルを指定し、画像を表示する表の列数を設定することができます。

 

関連トピック

Displaying Images
Attaching Files to a Page
Editing Attachment Properties
Working with Macros

Take me back to the Confluence User's Guide.

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