ページ ツリー マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

ページ ツリー マクロをページに追加すると、スペース内のページの階層の全部または一部を表示できます。  

このマクロは以下の場合に適しています。

  • 特定のプロジェクトについての複数のページが 1 つの親ページの下にまとめられている場合に、それらのページに素早く簡単に移動する
  • 目次として使用して、一連の手順のナビゲーションに役立てる
  • ドキュメンテーション スペースで、階層での現在の部分のページの概要を表示する 

On this page:

スクリーンショット: 2 つの階層レベルを示す、Confluence のページ ツリー マクロ。


このマクロをページに追加する

ページ ツリー マクロをページに追加するには:

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [Confluence コンテンツ] カテゴリから [ページ ツリー] を選択します。
  3. 表示するページ バージョンの数を選択します。 
  4. [挿入] をクリックします。 

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

スクリーンショット: 特定のページ下のすべてのページを別のスペースで表示する、ページ ツリー マクロの設定。 

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

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

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

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

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

パラメーター

既定

説明

ルート ページ
(root

スペースのホームページ

ページ ツリーの親ページを指定します。ツリーには指定されたページのすべての子と、それらの子と孫などが含まれます。ツリーには、ページ自体は含まれません

ページのタイトルまたは特別な値を次のように指定します:

  • ページ タイトル — ツリーの親やルートのページ名を指定します。ツリーには、指定したルートのすべての子と孫が含まれます。ツリーには、指定したルート ページ自体は含まれません
  • 「@home」— スペースのホーム ページ以下のすべてのページが含まれます (デフォルト)。
  • '@self' — 現在のページにすべてのページを含めます。
  • '@parent' — 現在のページの親ページの下のすべてのページ (現在のページを含む) を含めます。
  • '@none' — スペース内のすべてのページ (孤立ページや親ページを含む) を含めます。
このスペース キーに制限する現在のスペース

スペース名を入力して、別のスペースのページ ツリーを表示します。空白のままにすると、現在のスペースが使用されます。

ルート ページを別のスペースに指定する場合は、このパラメーターをルート ページのに設定します。

ページの並べ替え
(sort

職位

ツリー内でのページの表示順を指定します。この並べ替えは表示目的のみです。ページの順序を永続的に再配置するものではありません。次のいずれかの値を使用できます。

  • bitwise — アルファベット順に並べ替えます。例: title1、title10、title2。
  • 作成 — コンテンツの作成日順で並べ替えます。
  • modified — 最近変更された順に並べ替えます。
  • natural — 「自然数」のアルファベット順に並べ替えます。例: title1、title2、title10。
  • position — デフォルトの Confluence 並べ替え規則で並べ替えます。ページを手動で並べ替えた場合、この並べ替えは定義済みの順序を尊重します。そうでない場合、ページは「自然数」のアルファベット順で表示されます。例: title1、title2、title10。

ページ ツリーの抜粋を含む
(excerpt

false

ページツリーで各ページの抜粋を表示する場合に選択します。抜粋は、各ページで抜粋マクロを使用して定義する必要があります。

逆順ソート
(reverse

false

ページを自然な順序の逆 (降順) で表示する場合に選択します。並べ替えパラメーターと併用する必要があります。

ページ ツリーの上部の検索ボックスを含める
(searchBox

false

ページツリーの上の検索ボックスに含める場合に選択します。この検索ボックスでは、読者に指定した値のページ内での検索を許可することができます。

展開 / 折りたたみリンクの表示
(expandCollapseAll

false

ページツリーの一番上に「すべて展開」および「すべて折りたたみ」リンクを表示する場合に選択します。読者はこれらのリンクをクリックし、一度にツリーのすべてのブランチを開く/閉じることができます。

wikimarkup とストレージ形式で利用可能な値:

  • true – "すべて展開" および "すべて折りたたみ" オプションを表示する。
  • false – オプションを表示しない。

開始時の深さ
(startDepth

1

最初に開いたときに、ツリーに表示する子の数を設定するには、0 より大きい数を入力します。

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

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

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

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

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

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

マクロ名: pagetree

マクロ本文: なし。

{pagetree:root=Page Name|sort=natural|excerpt=true|reverse=false|startDepth=3|expandCollapseAll=true|searchBox=true}
最終更新日: 2023 年 10 月 13 日

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

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