子ページ表示マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

このマクロは、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

なし

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

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

サイト全体に適用するために、管理者がこのパラメーターを 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.

さらに、confluence.child-macro.disable-excerpt をダーク機能として使用して、子ページ表示マクロの抜粋を無効にすることもできます。

子ページの並べ替え
(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.