子ページ表示マクロ

このページの内容

お困りですか?

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

コミュニティに質問

robotsnoindex

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


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

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

  1. Confluence のエディタで、 > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

オートコンプリートでマクロを素早く入力する方法

  • 新しいエディタ - 「/」と要素 (ツールや挿入メニューのアイテム) の先頭の文字を入力すると、提案の一覧が表示されます。
  • 従来のエディタ - 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。

詳細については、「キーボード ショートカット、マークダウン、およびオートコンプリート」をご参照ください。


既存のマクロを編集する方法

マクロ プレースホルダーをクリックして、編集を選択します 。 マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。


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


パラメーター

パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。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

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

マクロ名: children

マクロ本文: なし。

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



最終更新日 2020 年 8 月 6 日

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

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