子ページ表示マクロ
子ページ表示マクロを使用して、ページの子ページ、さらに下位ページ(子ページの子ページ)を一覧にします。下のスクリーンショットに示すように、このマクロは既定で子ページへのリンクを表示します。表示する権限を持つページへのリンクのみ表示されます。
スクリーンショット:Confluence の子ページ表示マクロ
子ページ表示マクロを使用する
子ページ表示マクロを追加する方法
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化: タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
例
子ページのリストは子ページ表示マクロで生成されます:
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (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}