ギャラリー マクロを挿入する
ギャラリー マクロは、Confluence ページに添付された画像に基づき、サムネイル画像のコレクションを表形式で表示します。ページの閲覧中、ユーザーはサムネイル画像をクリックして拡大し、スクリーンサイズのスライドショーとして見ることができます。
概要:
ギャラリーに表示される画像は Confluence ページに添付されたファイルから取り込みます。ファイルが添付されている他のページを指定することも可能です。ページへの画像の添付に関する詳細情報については、ファイルのアップロードを参照してください。
画像の下部のキャプションは添付ファイルのコメントから取り込まれます。添付ファイルへのコメント追加に関する詳細情報については、ファイルのアップロードを参照してください。
既定値では、ページに添付されたすべての画像がギャラリーに表示されます。パラメーターを使用して画像を除外する/取り込むことも可能です。
画像は好みの順番に並べ替えることができます。
ギャラリーにタイトルを指定し、画像を表示する表の列数を設定することができます。
ギャラリー マクロを使用する
ギャラリー マクロを追加するには、次の手順に従います。
When editing, select from the toolbar
マクロを名前で検索して選択します。
必要に応じて設定します。
このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。
ギャラリー マクロを編集するには、次の手順に従います。
マクロのプレースホルダーを選択します。
Select the Edit icon to open the configuration panel.
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。
You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove the macro.
パラメーター
パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。
Confluence Cloud 保存形式で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載されます (example
)。
パラメーターの完全な一覧は以下の表のとおりです。添付ファイルまたはページの名前にカンマが含まれている場合、それをシングル クォーテーションまたはダブル クォーテーションで囲むと、下記の関連パラメータで参照できます。例: "this,that.jpg", theother.png
。
パラメーター | 既定 | 説明 |
---|---|---|
Gallery Title | なし | ギャラリーのタイトルを指定します。 |
Number of Columns | 4 | 表の列数を指定します。 |
Images to Exclude | 除外なし。ページのすべての写真を含める。 | ギャラリーは指定した写真を無視します。複数の写真をカンマ区切りで指定できます。 |
Include these Images Only | ページのすべての写真を含める | 1 つ以上の画像を指定して含めると、その画像のみがギャラリーに表示されます。カンマ区切りで複数の画像を指定できます。 このパラメーターのファイル名とファイルタイプは、大文字と小文字を区別します。たとえば、'my picture.PNG' は 'my picture.png' として認識されません。 |
Exclude Images with these Labels | 除外なし。ページのすべての写真を含める。 | ギャラリーは指定したラベルの付いた写真を無視します。複数のラベルをカンマ区切りで指定できます。添付ファイルにラベルを付ける方法については、「ラベルを使用してページと添付ファイルを整理する」を参照してください。 |
Include Images with these Labels Only | なし。画像はラベルでフィルタリングされません。 | ラベル リストに基づいて、表示する画像をフィルタリングします。カンマ区切りで複数のラベルを区切ります。Confluence は、指定した 1 つ以上のラベルを持つ画像を表示します (AND の反対である OR)。 添付ファイルにラベルを付ける方法については「ラベルを使用してページと添付ファイルを整理する」をご参照ください。 |
Use Images in these Pages | ページが指定されていない場合、ギャラリー マクロはマクロが使用されているページに添付された画像を表示します。 | 表示する画像を含むページのタイトルを指定します。複数のページ名をカンマ区切りで指定できます。異なるスペースのページを指定するには、以下の構文を使用します: |
Sort Images By | なし。並べ替え順が指定されていないため、順不同。 | 画像を並べ替える属性を指定します。並べ替え順は降順パラメーターを選択していない限り、 昇順です(以下参照)。オプションは次のとおりです。
|
Reverse Sort | オフ。並べ替え順は昇順。 | 上記のSort Images Byパラメーターと組み合わせて使用します。Reverse Sort により、並べ替え順を昇順から降順に変更します。 保存形式と Wiki マークアップで使用可能な値:
|
画像ファイル フォーマット
ページにはあらゆるフォーマットの画像ファイルを添付できます。Confluence がギャラリーマクロでの使用とページでの表示でサポートする画像フォーマットは以下のとおりです。
gif
jpeg
png
bmp (ブラウザのサポートによる)
Wiki マークアップの例
Wiki マークアップは従来のエディタでのみサポートされます。
Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。
マクロ名: gallery
マクロ本文: なし。
{gallery:title=My holiday pictures|reverse=true|sort=size|page=My page1, ds:Welcome to Confluence|excludeLabel=badlabel1, badlabel2|columns=3|exclude=badpicture.png}
この内容はお役に立ちましたか?