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

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

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

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

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

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

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

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

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

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

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

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

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

パラメーター

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

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

パラメーター

必須

既定

説明

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

(content)

いいえ

タイトル

利用可能な値:

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

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

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

時間枠
(time)

いいえ

制限なし

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

利用可能な値:

  • m - 分

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

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

  • w - 週

これらのラベルのみを表示
(label)

いいえ

なし

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

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

  • 指定したラベルに一致するコンテンツを除外するには、そのラベル値のすぐ前にマイナス記号 ( - ) を付けます。例: -badpage のラベル値を指定した場合、'badpage' のラベルが付いていないコンテンツのみ取得します。

  • 指定されたラベル値と結果を間違いなく一致させるには、そのラベルの値のすぐ前にプラス記号(+)を付けます。例:+superpage、+goodpageのラベル値を指定した場合、少なくとも 2 つのラベル、「 superpage 」と「 goodpage 」が付いたコンテンツしか取得しません。

これらの作者のみを表示 authors
(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パラメータが指定されていない場合、このパラメータは無視されます

ストレージ形式と wikimarkup では、値を 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}
最終更新日 2021年05月28日)
次でキャッシュ 3:48 PM on Oct 16, 2021 |

その他のヘルプ