ブログ投稿マクロ

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

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

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

In the Confluence editor, choose Insert > Other Macros.
Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログウィンドウが開きます。

パラメーター

Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

パラメーター	必須	既定	説明
表示するコンテンツの種類 (`content`)	いいえ	タイトル	利用可能な値: titles — Display only the title of each blog post. 抜粋 - 各ブログ投稿の短い抜粋を表示します。投稿に抜粋マクロが含まれている場合、ブログ投稿マクロは抜粋マクロで定義されたコンテンツを表示します。投稿に抜粋マクロが含まれていない場合、ブログ投稿マクロは投稿の最初の数行を表示します。全体 - 各ブログ投稿の全コンテンツを表示します。
タイムフレーム (`time`)	いいえ	制限なし	Confluence でブログ投稿をどこまでさかのぼって表示するか指定します。利用可能な値： `m` — 分 `h` — 時間。"`12h`" の場合、過去 12 時間以内に作成されたブログ投稿が表示されます。 `d` — 日。"`7d`" の場合、過去 7 日間に作成されたブログ投稿が表示されます。 `w` — 週
Restrict to these Labels `(label`)	いいえ	なし	ラベルを条件にしてフィルターをかけます。ここで指定したラベル（複数可）によってタグ付けされているブログ投稿だけがマクロによって表示されます。カンマまたはスペースで区切られた1つ以上のラベル値を指定します。 To exclude content which matches a given label, put a minus sign (-) immediately in front of that label value. For example: If you specify a label value of `-badpage` you will get only content which is not labelled with 'badpage'. 特定のラベル値を持つ結果のみを指定するには、ラベル値のすぐ前にプラス記号 (+) を追加します。例: ラベル値を `+superpage,+goodpage` と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。
Restrict to these Authors `(author`)	いいえ	なし	作成者を条件にしてフィルターをかけます。ここで指定した作成者（複数可）が書いたブログ投稿だけがマクロによって表示されます。
Restrict to these Spaces `(spaces`)	いいえ	@self、すなわちマクロが書かれたページを含むスペース	このパラメータを使用すれば、スペースを検索条件にしてコンテンツにフィルターをかけられます。ここで指定したスペース（複数可）に属するページだけがマクロによって表示されます。カンマまたはスペースで区切られた、1つ以上のスペースキーを指定します。特定のスペースのコンテンツを除外するには、スペースキーのすぐ前にマイナス記号 (-) を追加します。例: スペースキーを `-BADSPACE` と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。特定のスペースのコンテンツのみを指定するには、スペースキーのすぐ前にプラス記号 (+) を追加します。例: スペースキーを `+GOODSPACE` と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペースキーの前にプラス記号を設定してほかのスペースキーを一覧に追加した場合、追加したスペースキーは無視されます)。特別な値: `@self` — 現在のスペース。 `@personal` — All personal spaces. `@global` — All site spaces. `@favorite` — The spaces you have marked as favourite. `@favourite` — 上記の `@favorite` と同様。 `@all` — Confluence サイトのすべてのスペース。 `*` — 上記の `@all` と同様。個人用スペースを指定する場合、`~jbloggs` や `~jbloggs@example.com` のように、ユーザー名の前にチルダ (~) 記号をつける必要があることにご注意ください。
Maximum Number of Blog Posts `(max`)	いいえ	15	表示される結果の最大数を指定します。結果は最初にソートされ、その後、最大のパラメータが適用されることにご注意ください。
Sort By `(sort)`	いいえ	作成日	結果をソートする方法を指定します。このパラメーターを指定しない場合、作成日による降順（新しい順）が既定のソート順となります。値タイトル — タイトルのアルファベット順で並べ替え作成日 - コンテンツが追加された日付で並べ替え。更新日 - コンテンツが最後に更新された日付で並べ替え。
Reverse Sort `(reverse`)	いいえ	false	降順から昇順（古い順）に並べ替えを変更する場合に選択します。Sort Byパラメーターと合わせて、このパラメータを使用しますSort Byパラメータが指定されていない場合、このパラメータは無視されます In storage format and wikimarkup a value of `true` changes the sort order.

コードの例

次の例は、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}

ページツリー

ブログ投稿マクロ