ブログ投稿マクロを挿入する

ブログ投稿マクロを使えば、Confluence Cloud ページにブログを表示できます。タイトルをクリックすると、ブログ投稿に移動します。

ブログ投稿マクロを追加するには、次の手順に従います。

  1. When editing, select from the toolbar

  2. マクロを名前で検索して選択します。

  3. 必要に応じて設定します。

このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

ブログ投稿マクロを編集するには、次の手順に従います。 

  1. マクロのプレースホルダーを選択します。

  2. Select the Edit icon to open the configuration panel.

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

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

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)。

パラメーター

必須

既定

説明

表示するコンテンツの種類

(content)

いいえ

タイトル

利用可能な値:

  • タイトル - 各ブログ投稿のタイトル、作成者、スペース、作成日付スタンプを表示します。

  • excerpts — Display a short excerpt from each blog post. If the blog contains an excerpt macro, the blog posts macro will display the content defined in the excerpt macro. If the blog does not contain an excerpt macro, the blog posts macro will display either the first few sentences of the blog, or plain text information.

  • 全体 - 各ブログ投稿の全コンテンツを表示します。

Time Frame
(time)

いいえ

制限なし

Confluence でブログをどこまでさかのぼって表示するかを指定します。

利用可能な値:

  • m — 分

  • h — 時間「12h」の場合、過去 12 時間以内に作成されたブログが表示されます。

  • d — 日「7d」の場合、過去 7 日間に作成されたブログが表示されます。

  • w — 週

Restrict to these Labels
(label)

いいえ

なし

結果をラベルで絞り込みます。ここで指定したラベル (複数可) によってタグ付けされているブログだけが、マクロによって表示されます。

カンマまたはスペースで区切ることで、1 つ以上のラベル値を指定できます。

  • 特定のラベルに一致するコンテンツを除外するには、ラベルの値のすぐ前にマイナス記号 (-) を追加します。例: ラベル値を -badpage と指定すると、"badpage" のラベルを持たないコンテンツのみを取得できます。

  • To indicate that the results must match a given label value, put a plus sign (+) immediately in front of that label value. For example: If you specify a label value of +superpage,+goodpage you will get only content which has at least two labels, being 'superpage' and 'goodpage'.

Restrict to these Authors
(author

いいえ

なし

作成者を条件にしてフィルターをかけます。ここで指定した作成者(複数可)が書いたブログだけがマクロによって表示されます。

Restrict to these Spaces
(spaces

いいえ

@self、すなわちマクロが書かれたページを含むスペース

このパラメーターを使用すれば、スペースでコンテンツにフィルターをかけられます。ここで指定したスペース (複数可) に属するページのみが、マクロによって表示されます。

カンマまたはスペースで区切ることで、1 つ以上のスペース キーを指定できます。

  • 特定のスペースのコンテンツを除外するには、スペース キーのすぐ前にマイナス記号 (-) を追加します。例: スペース キーを -BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。

  • To indicate that the results must come from a specific space, put a plus sign (+) immediately in front of that space key. For example: If you specify a space key of +GOODSPACE you will get only content in GOODSPACE. (Note that this is not particularly useful, because each content item belongs to one space only. If you put a plus sign next to one space key and list other space keys too, the other space keys will be ignored.)

特別な値:

  • @self — 現在のスペース。

  • @personal — すべての個人用スペース。

  • @global — すべてのサイト スペース。

  • @favorite — お気に入りとしてマークしたスペース。

  • @favourite — 上記の @favorite と同様。

  • @all — Confluence サイトのすべてのスペース。

  • * — 上記の @all と同様。

個人用スペースを指定する場合、~jbloggs~jbloggs@example.com のように、ユーザー名の前にチルダ (~) 記号をつける必要があることにご注意ください。

Maximum Number of Blog Posts
(max)

いいえ

15

表示される結果の最大数を指定します。結果は最初にソートされ、その後、最大のパラメータが適用されることにご注意ください。

Sort By
(sort)  

いいえ

作成日

結果をソートする方法を指定します。このパラメーターを指定しない場合は、作成日による降順 (新しい順) が既定のソート順となります。

値:

  • タイトル — タイトルのアルファベット順で並べ替え

  • 作成日 - コンテンツが追加された日付で並べ替え。

  • 更新日 - コンテンツが最後に更新された日付で並べ替え。

 

Reverse Sort
(reverse) 

いいえ

false

Select to change the sort from descending to ascending order (oldest first). Use this parameter in conjunction with the Sort By parameter. This parameter is ignored if the Sort By parameter is not specified.

保存形式では、値を true にするとソート順が変わります。

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。