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

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

ページにブログ投稿マクロを追加するには：

パラメーター

パラメーター

必須

既定

説明

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

(content)

いいえ

タイトル

利用可能な値:

  • タイトル - 各ブログ投稿のタイトル、作成者、スペース、作成日付スタンプを表示します。
  • 抜粋 - 各ブログ投稿の短い抜粋を表示します。投稿に抜粋マクロが含まれている場合、ブログ投稿マクロは抜粋マクロで定義されたコンテンツを表示します。投稿に抜粋マクロが含まれていない場合、ブログ投稿マクロは投稿の最初の数行を表示します。
  • 全体 - 各ブログ投稿の全コンテンツを表示します。

タイム フレーム
(time)

いいえ

制限なし

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

利用可能な値：

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

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

いいえ

なし

Filter the results by label. The macro will display only the blog posts 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.

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

いいえ

なし

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

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

いいえ

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

This parameter allows you to filter content by space. The macro will display only the pages which belong to the space(s) you specify here.

You can specify one or more space keys, separated by a comma or a space.Special values:

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

いいえ

15

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

並べ替え順序
 (sort)  

いいえ

作成日

Specify how the results should be sorted. If this parameter is not specified, the sort order defaults to descending order (newest first) based on the creation date.

Values:

逆順ソート
(reverse)

いいえ

false

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

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

コー​​ドの例

次の例は、Confluence ページの基礎となるマークアップを編集したい上級ユーザーのために提供します。 

マクロ名: blog-posts

マクロ本文: なし。

保存形式の例

<ac:structured-macro ac:name="blog-posts">
  <ac:parameter ac:name="content">titles</ac:parameter>
  <ac:parameter ac:name="spaces">
    <ri:space ri:space-key="ds"/>
  </ac:parameter>
  <ac:parameter ac:name="author">
    <ri:user ri:userkey="12345678912345678912345678912345"/>
  </ac:parameter>
  <ac:parameter ac:name="time">4w</ac:parameter>
  <ac:parameter ac:name="sort">creation</ac:parameter>
  <ac:parameter ac:name="max">10</ac:parameter>
  <ac:parameter ac:name="labels">chocolate,cookies</ac:parameter>
</ac:structured-macro>

Wiki マークアップの例

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