ブログ投稿マクロ
ブログ投稿マクロを使えば、Confluence ページにブログ投稿を表示できます。タイトルをクリックすると、ブログ投稿に移動します。
ブログ投稿マクロを使用する
ページにブログ投稿マクロを追加するには：
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化： タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
パラメーター
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).
パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
表示するコンテンツの種類 ( | いいえ | タイトル | 利用可能な値:
|
タイム フレーム | いいえ | 制限なし | Confluence でブログ投稿をどこまでさかのぼって表示するか指定します。
|
これらのラベルだけを表示します | いいえ | なし | ラベルを条件にしてフィルターをかけます。ここで指定したラベル（複数可）によってタグ付けされているブログ投稿だけがマクロによって表示されます。
|
これらの作者だけを表示します | いいえ | なし | 作成者を条件にしてフィルターをかけます。ここで指定した作成者（複数可）が書いたブログ投稿だけがマクロによって表示されます。 |
これらのスペースだけを表示します | いいえ | @self、すなわちマクロが書かれたページを含むスペース | このパラメータを使用すれば、スペースを検索条件にしてコンテンツにフィルターをかけられます。ここで指定したスペース（複数可）に属するページだけがマクロによって表示されます。
個人用スペースを指定する場合、 |
ブログ投稿の最大数 | いいえ | 15 | 表示される結果の最大数を指定します。結果は最初にソートされ、その後、最大のパラメータが適用されることにご注意ください。 |
並べ替え順序 | いいえ | 作成日 | 結果をソートする方法を指定します。このパラメーターを指定しない場合、作成日による降順（新しい順）が既定のソート順となります。
|
逆順ソート | いいえ | false | 降順から昇順（古い順）に並べ替えを変更する場合に選択します。Sort Byパラメーターと合わせて、このパラメータを使用しますSort Byパラメータが指定されていない場合、このパラメータは無視されます ストレージ形式と wiki マークアップでは値を |
コードの例
次の例は、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}