子ページ表示マクロ
子ページ表示マクロを使用して、ページの子ページ、さらに下位ページ（子ページの子ページ）を一覧にします。下のスクリーンショットに示すように、このマクロは既定で子ページへのリンクを表示します。表示する権限を持つページへのリンクのみ表示されます。
スクリーンショット：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).
パラメーター | 既定 | 説明 |
|---|---|---|
子孫ページの表示 | false | すべての子孫ページを表示するか選択します。
|
親ページ | current | 子ページを表示するページを、現在のスペースか他のスペースか指定します以下を入力します：
|
子ページの数 | なし | トップレベル ページに表示される子ページの数を制限する。 |
子孫ページの深さ | なし | 表示する子孫の深さ (世代数) を示す数字を入力します。たとえば、値が 子孫ページの表示が有効な場合、この設定は無効になります。 |
ヘッダースタイル | なし | 子孫ページの表示に使用するスタイルを選択します。 |
抜粋を含む | なし | リストの各ページの下に短い抜粋を含めることができます。次から選択:
|
子ページの並べ替え | マニュアルで並べ替えた順、またはアルファベット順 | オプション。以下から選択してください：
|
逆順ソート | false | 子ページの並べ替えパラメーターを使用します。設定すると、昇順から降順に変更されます。 |
コードの例
次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。
マクロ名: children
マクロ本文: なし。
保存形式の例
<ac:structured-macro ac:name="children">
<ac:parameter ac:name="reverse">true</ac:parameter>
<ac:parameter ac:name="sort">creation</ac:parameter>
<ac:parameter ac:name="style">h4</ac:parameter>
<ac:parameter ac:name="page">
<ac:link>
<ri:page ri:content-title="Home"/>
</ac:link>
</ac:parameter>
<ac:parameter ac:name="excerpt">none</ac:parameter>
<ac:parameter ac:name="first">99</ac:parameter>
<ac:parameter ac:name="depth">2</ac:parameter>
<ac:parameter ac:name="all">true</ac:parameter>
</ac:structured-macro>Wiki マークアップの例
{children:reverse=true|sort=creation|style=h4|page=Home|excerpt=none|first=99|depth=2|all=true}