子ページ表示マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

このマクロは、Confluence Data Center と Confluence Cloud で使用できます。マクロの詳細については、「Confluence Cloud」を参照してください。

子ページ表示マクロをページに追加すると、ページ階層の特定の部分のページの一覧を表示できます。現在のページの子ページ、またはスペース内のその他のページの子ページの表示を選択できます。 

このマクロを使用すると、以下のページに簡単にアクセスできます。

  • あるプロジェクトに関連するページ 
  • 手順や使い方のページ

このマクロはページ階層に依存するため、ページの一覧は、ページの追加、削除、または移動時に自動的に更新されます。ページの抜粋を表示してコンテキストを追加することもできます。 

On this page:

スクリーンショット: プリンターについてのページの一覧を表示する、子ページ表示マクロ。

ページの見出しから目次を作成するには、「目次マクロ」をご覧ください。

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

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

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [Confluence コンテンツ] または [ナビゲーション] カテゴリから [子ページ表示] を選択します。
  3. 次のパラメーターを使用して、表示するページと表示方法を指定します。 
  4. [挿入] をクリックします。 

その後、ページを公開するとマクロの動作を確認できます。 

スクリーンショット: 子ページ表示マクロでの親ページと表示オプションの指定。


マクロ パラメーターを変更する

マクロ パラメーターは、マクロの動作を変えるために使用します。

マクロ パラメーターを変更するには、次の手順を実行します。

  1. エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
  2. 必要に応じてパラメーターを更新し、[挿入] を選択します。

このマクロで使用できるパラメーターの一覧は、次のとおりです。 

パラメーター

既定

説明

子孫ページの表示
(all

false

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

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

親ページ
(page

current

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

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

子ページの数
(first

なし

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

管理者はこのパラメーターに最大数を適用する場合があります。

子孫ページの深さ
(depth

なし

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

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

管理者はこのパラメーターに最大数を適用する場合があります。

ヘッダースタイル
(style

なし

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

Excerpt Display
(excerpt

なし

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

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

サイト全体に適用するために、管理者がこのパラメーターを none に設定している可能性がある点にご注意ください。

管理者向け

(info) The JVM parameter confluence.child-macro.disable-excerpt can be set to true to disable excerpts in children display macros. See Recognized System Properties for more details on this parameter and when it can be used.

Additionally, you can also use confluence.child-macro.disable-excerpt as a dark feature to disable excerpts in Children Display macros.

子ページの並べ替え
(sort

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

空白のままにしておくと、ページツリーに現在表示されている順番でページが表示されます。または、次を選択します。

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

逆順ソート
(reverse

false

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

Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

このマクロを追加するその他の方法

手入力でこのマクロを追加する

{」と入力してからマクロ名の入力を開始すると、マクロの一覧が表示されます。

Wiki マークアップを使用してこのマクロを追加する

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

マクロ名: children

マクロ本文: なし。

{children:reverse=true|sort=creation|style=h4|page=Home|excerpt=none|first=99|depth=2|all=true}
tip/resting Created with Sketch.

Confluence を使いこなす

Atlassian Marketplace で提供されている数百ものマクロを使用して、Confluence を拡張できます。Confluence ページの整理に活用できるアプリをいくつか紹介します。 

最終更新日 2024 年 9 月 30 日

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

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