子ページ表示マクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

robotsnoindex
robotsnoindex

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


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

子ページ表示マクロを追加するには、次の手順に従います。

  1. Confluence エディタで、 > [詳細を表示] の順に選択します
  2. 挿入するアイテムを探して選択します
  3. [挿入] を選択します。

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

子ページ表示マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。
  2. [編集] を選択します。右側のパネルが開きます。
  3. パラメーターを修正します。変更内容は、移動するごとに保存されます。
  4. ページの編集を再開すると、パネルが閉じます。


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


パラメーター

パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメーター名がブラウザで使用されるラベルと異なる場合は、以下に括弧付きで一覧表示されます (example)。

パラメーター

既定

説明

子孫ページの表示
(all

false

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

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

親ページ
(page

current

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

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

子ページの数
(first

なし

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

子孫ページの深さ
(depth

なし

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

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

ヘッダースタイル
(style

なし

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

抜粋を含む
(excerpt

なし

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

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

子ページの並べ替え
(sort

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

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

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

逆順ソート
(reverse

false

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

Wiki マークアップの例

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


robotsnoindex
robotsnoindex
robotsnoindex

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

マクロ名: children

マクロ本文: なし。

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



最終更新日 2023 年 6 月 19 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.