ブログ投稿マクロ
ブログ投稿マクロを使えば、Confluence ページにブログ投稿を表示できます。タイトルをクリックすると、ブログ投稿に移動します。
ブログ投稿マクロを使用する
ページにブログ投稿マクロを追加するには:
- エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートを活用して素早く入力: 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
パラメーター | 必須 | 既定 | 説明 |
---|---|---|---|
表示するコンテンツの種類 ( | いいえ | タイトル | 利用可能な値:
|
タイム フレーム | いいえ | 制限なし | Confluence でブログ投稿をどこまでさかのぼって表示するか指定します。
|
これらのラベルだけを表示します | いいえ | なし | ラベルを条件にしてフィルターをかけます。ここで指定したラベル(複数可)によってタグ付けされているブログ投稿だけがマクロによって表示されます。
|
これらの作者だけを表示します | いいえ | なし | 作成者を条件にしてフィルターをかけます。ここで指定した作成者(複数可)が書いたブログ投稿だけがマクロによって表示されます。 |
これらのスペースだけを表示します | いいえ | @self、すなわちマクロが書かれたページを含むスペース | このパラメータを使用すれば、スペースを検索条件にしてコンテンツにフィルターをかけられます。ここで指定したスペース(複数可)に属するページだけがマクロによって表示されます。
個人用スペースを指定する場合、 |
ブログ投稿の最大数 | いいえ | 15 | 表示される結果の最大数を指定します。結果は最初にソートされ、その後、最大のパラメータが適用されることにご注意ください。 |
並べ替え順序 | いいえ | 作成日 | 結果をソートする方法を指定します。このパラメーターを指定しない場合、作成日による降順(新しい順)が既定のソート順となります。
|
逆順ソート | いいえ | false | 降順から昇順(古い順)に並べ替えを変更する場合に選択します。Sort Byパラメーターと合わせて、このパラメータを使用しますSort Byパラメータが指定されていない場合、このパラメータは無視されます ストレージ形式と wiki マークアップでは値を |
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: blog-posts
マクロ本文: なし。
{blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookies}