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

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

ブログ投稿マクロを使用する

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

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

  2. 挿入するアイテムを探して選択します

  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。

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

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。

  2. 編集を選択します。右側のパネルが開きます。

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

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

パラメーター

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

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します (example)。

パラメーター

必須

既定

説明

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

(content)

いいえ

タイトル

利用可能な値:

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

  • 抜粋 - 各ブログ投稿の短い抜粋を表示します。投稿に抜粋マクロが含まれている場合、ブログ投稿マクロは抜粋マクロで定義されたコンテンツを表示します。投稿に抜粋マクロが含まれていない場合、ブログ投稿マクロは投稿の最初の数行を表示します。

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

タイム フレーム
(time)

いいえ

制限なし

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

利用可能な値:

  • m — 分

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

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

  • w — 週

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

いいえ

なし

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

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

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

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

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

いいえ

なし

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

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

いいえ

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

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

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

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

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

特別な値:

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

  • @personal — すべてのパーソナル スペース。

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

  • @favorite — ユーザーがお気に入りとして設定したすべてのスペース。

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

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

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

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

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

いいえ

15

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

並べ替え順序
(sort)  

いいえ

作成日

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

値:

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

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

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

 

逆順ソート
(reverse) 

いいえ

false

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

ストレージ形式と wiki マークアップでは値を true にするとソート順が変わります。

 

Wiki マークアップの例

Wiki マークアップは従来のエディタでのみサポートされます。

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

マクロ名: blog-posts

マクロ本文: なし。

1 {blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookies}

その他のヘルプ