The Page Tree macro displays a dynamic, hierarchical list of pages starting from a specified parent (root) page. It can act as a table of contents or a list of related topics.

When viewing the page tree, your reader can click a link to view the relevant page. The page's current position is highlighted in the page tree.

Creating a navigation panel for your space

The Page Tree macro is used in the Confluence Documentation theme, to create a navigation panel showing a table of contents for your space. Read the instructions on Configuring the Documentation Theme.

ページツリー マクロの使用

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

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

Click Refresh in the Macro Browser to see the effect of changes to the macro parameters.

マクロ パラメーター

When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.

Parameters are options that you can set for Confluence macros to control the content or format of the macro output. The table below lists parameters for this macro that can be set in the Macro Browser.

パラメーター

既定

説明

Root Page

スペースのホームページ

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

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

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

Sort Pages By

職位

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

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

Include Excerpts in Page Tree

false

Select if you want the page tree to show excerpts from each page. The excerpts must be defined on each page by the Excerpt macro.

Reverse Order

false

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

Include Search Box above Page Tree

false

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

Show Expand/Collapse Links

false

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

Start Depth

1

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

関連トピック

Page Tree Search Macro
Adding a Navigation Sidebar
Working with Macros

Take me back to the Confluence User's Guide.

  • ラベルなし