子ページ表示マクロ
子ページ表示マクロを使用して、ページの子ページ、さらに下位ページ(子ページの子ページ)を一覧にします。下のスクリーンショットに示すように、このマクロは既定で子ページへのリンクを表示します。表示する権限を持つページへのリンクのみ表示されます。
スクリーンショット:Confluence の子ページ表示マクロ
子ページ表示マクロを使用する
子ページ表示マクロを追加する方法
- From the editor toolbar, choose (Insert) > Other Macros
- 対象のマクロを見つけて、選択します。
Speed it up with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. In this example we're inserting the cheese macro.
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
例
子ページのリストは子ページ表示マクロで生成されます:
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
パラメーター | 既定 | 説明 |
---|---|---|
子孫ページの表示 | false | すべての子孫ページを表示するか選択します。
|
親ページ | current | 子ページを表示するページを、現在のスペースか他のスペースか指定します以下を入力します:
|
子ページの数 | なし | トップレベル ページに表示される子ページの数を制限する。 |
子孫ページの深さ | なし | 表示する子孫の深さ (世代数) を示す数字を入力します。たとえば、値が 子孫ページの表示が有効な場合、この設定は無効になります。 |
ヘッダースタイル | なし | 子孫ページの表示に使用するスタイルを選択します。 |
抜粋を含む | なし | リストの各ページの下に短い抜粋を含めることができます。次から選択:
|
子ページの並べ替え | マニュアルで並べ替えた順、またはアルファベット順 | オプション。以下から選択してください:
|
逆順ソート | false | 子ページの並べ替えパラメーターを使用します。設定すると、昇順から降順に変更されます。 |
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: children
マクロ本文: なし。
{children:reverse=true|sort=creation|style=h4|page=Home|excerpt=none|first=99|depth=2|all=true}