子ページ表示マクロを使用して、ページの子ページ、さらに下位ページ（子ページの子ページ）を一覧にします。下のスクリーンショットに示すように、このマクロは既定で子ページへのリンクを表示します。表示する権限を持つページへのリンクのみ表示されます。

スクリーンショット：Confluence の子ページ表示マクロ

子ページ表示マクロを使用する

子ページ表示マクロを追加する方法

例

子ページのリストは子ページ表示マクロで生成されます：

パラメーター

パラメーター

既定

説明

子孫ページの表示
(all) 

false

すべての子孫ページを表示するか選択します。

true の場合、子孫ページの深さにかかわらず、親ページ配下の完全なページ ツリーを表示します。

親ページ
(page) 

current

子ページを表示するページを、現在のスペースか他のスペースか指定します以下を入力します：

  • '/' — 現在のスペースのトップレベルのページ (親ページを持たないページ) を一覧表示します。
  • 'pagename' — 指定されたページの子ページを一覧表示。
  • 'spacekey:' — 指定されたスペースのトップレベルのページを一覧表示。
  • 'spacekey:pagename' — 指定されたスペースの指定されたページの子ページを一覧表示。

子ページの数
(first) 

なし

トップレベル ページに表示される子ページの数を制限する。

子孫ページの深さ
(depth) 

なし

表示する子孫の深さ (世代数) を示す数字を入力します。たとえば、値が 2, の場合、2 つ分のレベルの子ページを表示します。

子孫ページの表示が有効な場合、この設定は無効になります。

ヘッダースタイル
(style) 

なし

子孫ページの表示に使用するスタイルを選択します。

抜粋を含む
(excerpt) 

false

返されたページに抜粋マクロがある場合、このオプションにチェックが入っていると抜粋の 1 行目が表示されます。

抜粋マクロがないページには何も表示されません。

子ページの並べ替え
(sort) 

マニュアルで並べ替えた順、またはアルファベット順

オプション。以下から選択してください：

  • 作成 — コンテンツの作成日順で並べ替え
  • タイトル — タイトルのアルファベット順で並べ替え
  • 変更 — 最終変更日で並べ替え

逆順ソート
(reverse) 

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">true</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=true|first=99|depth=2|all=true}