子ページ表示マクロを挿入する

子ページ表示マクロを使用して、マクロが挿入されたページの子ページを一覧にします。次のスクリーンショットに示すように、このマクロは既定で子ページへのリンクを表示します。ユーザーが表示権限を持つページへのリンクのみが表示されます。

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

子ページ表示マクロを追加するには:

  1. 編集時には、ツールバーから を選択します。

  2. 挿入するアイテムを探して選択します

  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。

子ページ表示マクロを編集するには:

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。

  2. 編集を選択します。右側のパネルが開きます。

  3. パラメータを修正します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

子ページ表示マクロを使用して表示されるページ リンクは、ページの子ページに応じて動的に変更されます。ページ タイトルを変更するには、実際の子ページに移動してページ タイトルを編集します。

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します ()。

パラメーター

既定

説明

Show Descendants
(all

false

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

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

Parent Page
(page

current

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

  • '/' — 現在のスペースのトップレベル ページ (親ページなし) をリストする。

  • 'pagename' — 指定されたページの子ページをリストする。

  • 'spacekey:' — 指定されたスペースのトップレベル ページをリストする。

  • 'spacekey:pagename' — 指定されたスペースの指定されたページの子ページをリストする。

Number of Children
(first

なし

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

Depth of Descendants
(depth

なし

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

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

Heading Style
(style

なし

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

Include Excerpts
(excerpt

なし

リストの各ページの下に短い抜粋を含めることができます。次から選択:

  • なし - 抜粋は表示されません

  • シンプル - 返された任意のページの抜粋マクロに含まれる、テキストの最初の文字を表示します。ページに抜粋マクロがない場合は、何も表示されません。

  • リッチ コンテキスト - 抜粋マクロ以外のコンテンツを表示します。ページに抜粋マクロがない場合、ページのコンテンツの最初の部分 (書式設定されたテキスト、画像、および一部のマクロを含む) が表示されます。

Sort Children By
(sort

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

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

  • 作成 — コンテンツの作成日順で並べ替え

  • タイトル — タイトルのアルファベット順で並べ替え

  • 変更 — 最終変更日で並べ替え

Reverse Sort
(reverse

false

子ページの並べ替えパラメーターを使用します。設定すると、昇順から降順に変更されます。

Wiki マークアップの例

Wiki マークアップは従来のエディタでのみサポートされます。

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

Macro name: children

マクロ本文: なし。

1 2 3 4 {children:reverse=true|sort=creation|style=h4|page=Home|excerpt=none|first=99|depth=2|all=true}

 

その他のヘルプ