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