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

The blog posts macro allows you to display blogs on a Confluence Cloud page. Selecting a title takes you to the blog post.

ブログ投稿マクロを追加するには:

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

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

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

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

ブログ投稿マクロを編集するには: 

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

  2. [編集] アイコン を選択して、設定パネルを開きます。

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

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

中央揃え アイコン、幅 アイコン、全幅 アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱 アイコンを選択します。

パラメーター

パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。 

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.

  • entire - Display the entire content of each blog post.

タイム フレーム
(time)

いいえ

制限なし

Specify how far back in time Confluence should look for the blogs to be displayed.

Available values:

  • m — 分

  • h — Hours, so '12h' displays blogs created in the last twelve hours.

  • d — Days, so '7d' displays blogs created in the last seven days.

  • w — 週

これらのラベルだけを表示します
(label)

いいえ

なし

Filter the results by label. The macro will display only the blogs which are tagged with the label(s) you specify here.

You can specify one or more label values, separated by a comma or a space.

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

  • 特定のラベル値を持つ結果のみを指定するには、ラベル値のすぐ前にプラス記号 (+) を追加します。例: ラベル値を +superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。

これらの作者だけを表示します
(author

いいえ

なし

Filter the results by author. The macro will display only the blogs which are written by the author(s) you specify here.

これらのスペースだけを表示します
(spaces

いいえ

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

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

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

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

  • 特定のスペースのコンテンツのみを指定するには、スペース キーのすぐ前にプラス記号 (+) を追加します。例: スペース キーを +GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。

特別な値:

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

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

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

  • @favorite — The spaces you have marked as favorite.

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

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

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

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

ブログ投稿の最大数
(max)

いいえ

15

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

並べ替え順序
(sort)  

いいえ

作成日

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

値:

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

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

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

 

逆順ソート
(reverse) 

いいえ

false

降順から昇順(古い順)に並べ替えを変更する場合に選択します。Sort Byパラメーターと合わせて、このパラメータを使用しますSort Byパラメータが指定されていない場合、このパラメータは無視されます

In storage format, a value of true changes the sort order.

 

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

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